Path: utzoo!attcan!utgpu!news-server.csri.toronto.edu!cs.utexas.edu!usc!apple!jdevoto
From: jdevoto@Apple.COM (Jeanne A. E. DeVoto)
Newsgroups: comp.sys.mac.hypercard
Subject: Re: Picture
Summary: The Book is *cough* wrong.
Message-ID: <47586@apple.Apple.COM>
Date: 24 Dec 90 10:48:25 GMT
References: <1990Dec17.154532.8903@informix.com>
Organization: Apple Computer Inc., Cupertino, CA
Lines: 55

In article <1990Dec17.154532.8903@informix.com> robertw@informix.com
(Rob Weinberg) writes concerning the picture XCMD in HyperCard 2.0:

>OK, I'm missing something.

No, you're not :-). While HC 2.0: TB is of exemplary accuracy and completeness
on most issues (hi, Scot), its documentation of the picture XCMD is, um, wrong.
(I suspect that when TB went to press, the XCMD was still in flux.) There is
some documentation available in the Power Tools stack in the 5-disk HyperCard
distribution, and by combining this with the documentation in TB you can get
a fairly complete picture (no pun intended).

Basically, the syntax is

  picture <name>[,<source>[,<style>[,<visible>[,<bitDepth>]]]]

where
  <name> is the name of the PICT or MacPaint file or PICT resource.
  <source> is "file", "resource" or "clipboard". "File" is the default.
  <style> is rect, shadow, dialog, plain (ordinary title bar and close
    box, no scroll bars, no zoom box), zoom (title bar, close box, scroll
    bars, zoom box), roundRect (black title bar with white lettering and
    close box), document (scroll bars but no zoom box), windoid (like
    plain but with a gray title bar), or windoidZoom (like zoom but ditto).
  <visible> is true or false and indicates the state of the window when
    first opened.
  <bitDepth> is a power of two between 0 and 32. If a bitDepth of 0 is
    used, the picture is drawn directly into the window.

The window accepts the following properties:

  the dithering of <picture name>: true or false
  the visible: true or false
  the loc (in terms of card window coordinates)
  the rect
  the globalLoc (in terms of screen coordinates)
  the globalRect
  the scroll
  the zoom: true or false
  the scale: an integer between -5 and 5, which is the power of two to which
     the window is scaled.

The following messages are sent to the current card:

  openWindow <picture name>
  closeWindow <picture name>
  mouseDownInPicture <picture name>,<clickLoc> (relative to the picture window)
  mouseUpInPicture <picture name>,<clickloc>
-- 
========= jeanne a. e. devoto ========================================
 jdevoto@apple.com     |  You may not distribute this article under a
 jdevoto@well.sf.ca.us |  compilation copyright without my permission.
______________________________________________________________________
 Apple Computer and I are not authorized      |        CI$: 72411,165
 to speak for each other.                     |