iMagine Photo.app terminology

/Applications/iMagine Photo copy/iMagine Photo.app

Standard Suite

Common terms for most applications

Commands

  • close -- Close an object
    • reference -- the objects to close
    • [saving yes / no / ask] -- specifies whether or not changes should be saved before closing
    • [in alias] -- the file in which to save the object
  • copy -- Copy the picture with the applied transformations to the clipboard.
  • count -- Return the number of elements of a particular class within an object
    • reference -- the object whose elements are to be counted
    • each type class -- the class of the elements to be counted
    • Result: integer -- the number of elements
  • data size -- Return the size in bytes of an object
    • reference -- the object whose data size is to be returned
    • Result: integer -- the size of the object in bytes
  • exists -- Verify if an object exists
    • Result: boolean -- true if it exists, false if not
  • get -- Get the data for an object
    • reference -- the object whose data is to be returned
    • Result: anything -- The data from the object
  • make -- Make a new element
    • new type class -- the class of the new element
    • [at location reference] -- the location at which to insert the element
    • [with data anything] -- the initial data for the element
    • [with properties record] -- the initial values for the properties of the element
    • Result: reference -- Object specifier for the new element
  • open -- Open the specified object(s)
    • reference -- Objects to open. Can be a list of files or an object specifier.
  • set -- Set an object’s data
    • reference -- the object to change
    • to anything -- the new value

Classes

  • application -- An application program
    • Properties:
      • available exporter types (r/o) list of Unicode text -- A list of the available graphic exporter types.
      • run in background boolean -- The background only property, indicates whether iMagine is running in the background or not. When you set this property, iMagine must be restarted for the background property to take effect.
      • quit delay unsigned integer -- the time in seconds the application will idle before quitting; if set to zero, idle time will not cause the application to quit. iMagine will only quit if no documents are open.
      • compressor types (r/o) list of Unicode text -- A list of the available types for compressing movie frames.
    • Elements:
  • window -- A Window
    • Inherited by:
    • Properties:
      • bounds bounding rectangle -- the boundary rectangle for the window
      • closeable (r/o) boolean -- Does the window have a close box?
      • titled (r/o) boolean -- Does the window have a title bar?
      • index integer -- the number of the window
      • floating (r/o) boolean -- Does the window float?
      • modal (r/o) boolean -- Is the window modal?
      • resizable (r/o) boolean -- Is the window resizable?
      • zoomable (r/o) boolean -- Is the window zoomable?
      • zoomed boolean -- Is the window zoomed?
      • name international text -- the title of the window
      • visible (r/o) boolean -- is the window visible?
      • position (r/o) point -- upper left coordinates of window

Type Definitions Suite

Provides a set of abstract classes which are used as the base classes for other classes and other definitions.

Classes

  • composition element -- Shape drawing and filter effect classes inherit their properties from this class. These objects are created using the create composition element command which can be used on graphic or window documents.
    • Plural name:
      • composition elements
    • Inherited by:
    • Properties:
      • class filled rectangle / filled oval / framed oval / framed rectangle / framed arc / filled arc / filled poly / framed poly / standard line / pixel / multicolored pixel / framedQuartz / filledQuartz / standard text / centre gradient / RGB balance / detect edges / emboss / sharpen / color style / color tint / color sync / HSL balance / brightness and contrast / blur / alpha gain / bilinearInterpoloate -- Every composition element must have a class. Required in all “create new composition element with properties theProp” commands in the theProp record.
      • background color RGB color -- The background color for drawing. Also an optional property of the “color tint” filter type. It is only ever an optional property.
      • color RGB color -- The color for drawing shapes with. Required for drawing all shapes and is also required by the “color tint” filter type when tint type “other” is specified.
      • bounds rectangle (r/o) bounding rectangle -- A required property for drawing various shapes and an optional property for applying filters. Specifies the limits of the area in which a shape is to be drawn or a filter to be applied. Not used for drawing text or lines.
  • filter -- An abstract class from which all the filter classes inherit. The “class” for a filter has to be one of the types from “centre gradient” to “alpha gain”.
  • exif user data -- An abstract class to define the properties for reading and writing different exif user data types.
    • Properties:
      • exif type (r/o) copyright / artist / exif make / exif model / info / aperture fNum / exposure time in seconds / ISO film speed / exposure bias EV / focal length mm / capture date / capture width in pixels / capture height in pixels / flash / metering mode / gps latitude ref / gps longitude ref / gps altitude ref / gps latitude / gps longitude / gps altitude / exposure program / subject distance / light source / orientation / captureDateSubSecondTime -- When reading exif user data from a graphic importer a list of exif types is returned.
      • exif text string -- The text for the defined exif type.
      • exif float (r/o) small real -- A floating point number for the defined exif type
      • exif int (r/o) integer -- An integer for the defined exif type
      • exif unicode (r/o) Unicode text -- Unicode text for the defined exif type.
  • importer -- An importer cannot be created. An importer defines the properties common to both the graphic and movie importer classes which inherit their properties from this class. The list of importers includes both graphic and movie importers.
    • Plural name:
      • importers
    • Inherited by:
    • Properties:
      • scale list of small real -- The horizontal and vertical scaling. Horizontal first followed by the vertical. It is a list of 2 real numbers.
      • rotation small real -- The angle of rotation in degrees that the image should be rotated by. Clockwise direction is positive. As a real number.
      • drawing destination record -- The graphic document or window document where this importer will be drawing to. Write only property.
      • parent folder (r/o) alias -- The parent folder of the imported graphic file.
      • properties (r/o) record -- Returns all relevant information about the imported picture.
      • graphic type (r/o) international text -- The graphic type of the imported file.
      • file location (r/o) alias -- The location of the imported graphic or movie.
      • destination rectangle bounding rectangle -- The destination rectangle to draw to. Modifies the transformation matrix to achieve the required destination rectangle.
      • file name (r/o) Unicode text -- The file name of the imported graphic or movie file.
      • top left point point -- The top left of the drawing destination. Translates the drawing destination to the specified point.
      • translation point -- Translate the location of the destination rectangle by the amount specified. +ve is to the right and down. Translation is a write only property.
      • natural bounds (r/o) bounding rectangle -- The bounds of the original image in pixels. To set the source rectangle to its original state do: set source rectangle to the natural bounds.
      • transformation matrix list of small real -- Specifies the transformation matrix. See documentation for the order of the elements. To see how the transformation matrix changes, apply rotations and translations and see which elements change.
      • component error integer -- Critical error. The importer cannot be worked on if this error is set. If you know what the problem is and have recovered from it, you can clear this error by setting it to 0.
      • last operation error (r/o) integer -- The last operation error. If not 0 means the last operation failed, but if the component error is 0 then the graphic importer is still valid.
      • exif data (r/o) list of record -- A record of the exif data types currently interpreted by iMagine. See the property exif type defined in the exif user data record class of the “Type Definitions Suite” for a list of known types. All known types are returned in one record.
      • inset clipping difference point -- Inset the clipping area and set the clipping area to be the difference between the original clipping area and the inset area. See inset clipping for further details. Works only on the area specified by clipping points. Write only property.
      • inset clipping point -- Inset the clipping area by the number of pixels. Horizontal and vertical. Positive values shrink the area, negative values increase the area size. Works only on the area specified by clipping points. Write only property.
      • clipping points list of point -- An array of points {horizontal, vertical} that specify a polygon to clip future drawing. To remove the clipping region set to an empty list. Write only property.
    • Elements:
  • alpha transparency -- An abstract class to describe the properties that are used for setting the alpha channel of a graphic document.
    • Properties:
      • source document reference -- The graphic document to get the data for the alpha channel from.
      • color channel red channel / green channel / blue channel / average of / reference color / clear alpha -- The color channel to use as the source for the alpha channel. “reference color” requires that a color is specified and the optional property can be set.
      • inverted boolean -- Is the value of the channel inverted before being applied as an alpha channel.
      • color RGB color -- The reference color around which the alpha channel value is calculated based on the difference between the reference color and the pixel color.
      • slope small real -- Slope is only used when the color channel is “reference color”. Defines how quickly the alpha value changes based on the difference between the reference color and the pixel color.
      • chroma width RGB color -- Chroma width. Specified as a color. Black (0,0,0) indicates that only the chroma color will be 100% transparent. White (65535, 65535, 65535) would result in all colors being 100% transparent.
  • sample -- Properties for taking a movie frame.
    • Properties:
      • source document (r/o) reference -- The graphic document to be the image source for the movie frame.
      • source rectangle (r/o) bounding rectangle -- The rectange in the graphic document that will be used as the image for the append frame command.
      • sample duration (r/o) integer -- The duration of the sample. A duration of 600 is 1 second. If you want a sample rate of 10 frames second then you should use a duration of 60.

iMagine Suite

Apple Script functionality added by iMagine.

Commands

  • create composition element -- Create a composition element. The with properties record is required, as it defines the type of composition element plus the parameters specific to the type of element.
    • graphic document -- Only graphic and window documents can handle this command.
    • with properties record -- The property class is required, as it defines what type of composition element is to be created. Other properties are required or optional depending on the class.
  • clear transformations -- Clears all the transformations, returning the graphic or movie importer back to its original state.
    • importer -- A graphic or movie importer handle this event.
  • undo drawing -- Remove the last command from the drawing and filter history.
    • graphic document -- a graphic or window document or a graphic or movie importer.
  • undo drawing without refreshing -- Remove the last command from the drawing and filter history without updating the image.
  • refresh -- Erases the image area and then applies all the drawing and filter commands in their original order.
  • draw -- Tells the graphic or movie importer to draw into the graphic or window document.
    • importer -- A graphic or movie importer.
  • import graphic -- import the graphic document.
    • reference -- Import the file(s)
    • Result: reference -- Object specifier for the element created from the imported graphic file.
  • import movie -- Import the movie file.
    • reference -- Import the file(s)
    • Result: reference
  • import -- Import graphic or movie files. This is a slower way of opening movie files because the graphic importer will try and open them first. GIF and PDF files will both be imported as images and you will not be able to access the images after the first frame.
    • reference -- Import the file(s)
    • Result: reference -- The object that will be created.
  • open offscreen -- open the file and create an off screen document where the opened graphic file becomes the background.
    • reference -- Files to open into an offscreen graphics world.
  • export -- Export the graphic to the previously specified location.
    • reference -- Any object that has a graphic exporter attached. Window and graphic documents create graphic exporters by default. A graphic importer can be told to make a graphic exporter using the make exporter command.
  • make exporter -- Similar to the standard suite make new event except that it only creates exporters and the only object that will handle this event is the graphic importer class.
    • reference -- A graphic importer.
    • with properties record -- With any properties that can be set for a graphic exporter. Default graphic type is JPEG and if you change the graphic type later the other properties will be forgotten.
  • get text dimensions -- Get the text dimensions for the specified record.
    • with properties record -- The properties are a record that you could pass to create composition element with the class property set to “standard text”
    • Result: point
  • get pixel values -- Get the pixel values from the specified shape or list of points. This event can produce a huge amount of data so be careful.
    • graphic document -- Only graphic or window documents can handle this event.
    • with properties record -- Required property is pixel value class. Depending on pixel value class the other property is bounds rectangle, polygon points, pixel points, or start point and end point.
    • Result: record -- A record containing a list of points and a list of pixel values at those points.
  • get bad pixels -- Get a list of rectangles that contain bad pixels.
    • graphic document -- Only graphic or window documents can handle this event.
    • using rules record -- A record or list of records that contain properties that define the rules for detecting bad pixels. See class bad pixels for the specified properties.
    • Result: list of bounding rectangle -- A list rectangles containing bad pixels.
  • append sample -- Append the sample to the end of the movie. The sample is defined by the graphic document, the source rectangle in the graphic document and the duration of the sample.
    • movie editor -- Movie editors only can append frames.
    • with properties record -- The properties are defined in the class sample.

Classes

  • graphic importer -- A graphics importer object, that is used to import a graphic file.
    • Plural name:
      • graphic importers
    • Inherits from:
    • Properties:
      • bit depth (r/o) integer -- The bit depth of the imported graphic file.
      • source rectangle bounding rectangle -- The source rectangle that the graphic importer will draw from.
      • transformed source rect corners (r/o) list of point -- The corners of the source rectangle, transformed by the current transformation matrix.
      • resolution (r/o) list of small real -- The resolution of the imported graphic file.
      • opcolor RGB color -- A property of the graphic importer, it is relevant when the graphics mode is blend, add pin or sub pin. The effect of opcolor changes is dependent on which graphics mode is being used. Please see the documentation.
      • graphics mode blend / add pin / add over / sub pin / transparent / add max / sub over / add min / dither copy / straight alpha / pre white alpha / pre black alpha / composition / alpha blend / pre mul color alpha / alphaAsGray -- The graphics mode for the drawing command. I would recommend using the modes “blend” ... “dither copy”. The alpha modes can be used on graphics with an alpha channel. The graphics modes blend, add pin and sub pin all use opcolor.
      • drawing mode record -- A record containing the graphics mode and the opcolor.
      • image count (r/o) integer -- The number of images in the picture file.
      • image index integer -- The image index. Set to specify which image in the picture file that you want to be processing. The range is from 1 to image count.
      • drawing quality minimum / low / medium / high / maximum / lossless -- The drawing quality that the graphic importer will use when drawing. Default is lossless.
      • DONTgamma correct boolean -- Set to true if you wish to stop quicktime from doing gamma correction even when it thinks it should.
      • DONTcolor match boolean -- Set to true if you wish to stop quicktime from color matching even when quicktime thinks it is appropriate to do so.
      • color space (r/o) rgb / cmyk / lab / xyz / gray / fiveChannel / sixChannel / sevenChannel / eightChannel / fiveColor / sixColor / sevenColor / eightColor -- color space of the image's color representation.
  • movie importer -- A movie importer is created by importing a movie file. “set thisMovie to import move file “path:to:movie.mov”. A movie importer will then allow you to draw frames from the movie.
    • Inherits from:
    • Inherited by:
    • Properties:
      • current time integer -- The current time of the movie. To calculate the time in seconds, divide by the time scale which is the number of frames a second.
      • time scale (r/o) integer -- The time scale is the base time unit against which the other time units are measured. Normally the time scale is 600. For example a sample duration of 30 is 30 time scale units and is a frame rate of 20 frames per second.
      • movie duration (r/o) integer -- The length of the movie. To calculate the time in seconds, divide by time scale which is the number of frames a second.
      • first video sample (r/o) integer -- The time of the first video sample. To calculate the time in seconds, divide by the time scale which is the number of frames a second.
      • next video sample (r/o) integer -- The time of the next video sample. To calculate the time in seconds, divide by the time scale which is the number of frames a second.
      • previous video sample (r/o) integer -- The time of the previous video sample. To calculate the time in seconds, divide by the time scale which is the number of frames a second.
      • next sync sample (r/o) integer -- The time of the next synced video sample (A frame that doesn’t rely on previous frames to draw correctly). To calculate the time in seconds, divide by the time scale which is the number of frames a second.
      • previous sync sample (r/o) integer -- The time of the previous synced video sample (A frame that doesn’t rely on previous frames to draw correctly). To calculate the time in seconds, divide by the time scale which is the number of frames a second.
      • maximum samples integer -- The maximum number of frames returned by sync frames and drawing frames. -1 indicates that all valid frames of the required type should be returned.
      • sync samples (r/o) list of integer -- Returns a list of frames from the current frame (included if a sync frame) that are sync frames. The number of frames returned is limited by that specified in maximum frames. The frames are specified by their time.
      • drawing samples (r/o) integer -- Returns a list of frames that draw. The maximum number of frames that is returned is limited by the maximum samples property. The frames are specified by their time.
  • movie editor -- The make new command will allow you to create a movie editor. “make new movie editor with properties {dimensions:{640, 480}. The with properties option is required. There is only one required property and no optional properties.
    • Inherits from:
    • Properties:
      • export file location «class furl» -- The location of the file to export to.
      • export folder location file specification -- The location of the folder where the graphic will be exported to. A file name will also be required before the graphic can be exported.
      • export file name international text -- The file name that the graphic will be exported as.
      • export file extension (r/o) international text -- The default file name extension for the graphic format the file will be exported as, including the point (.).
      • export properties record -- A record of graphic exporter properties that can be set. Allowing you to set multiple properties in one call. This is a write only record, you can obtain all possible information using the other properties.
      • data compressor Unicode text -- The compressor type to use to compress each frame of the movie data. The application property compressor types will return a list of all the possible compressor types. Can only be set while is editing is false.
      • compression depth integer -- The bit depth of the compressed data. Possible values are 1, 2, 4, 8, 16, 24, 32, 33, 34, 36, 40.
      • compression quality minimum / low / medium / high / maximum / lossless -- The quality of the produced image that the compressor will aim for when compressing the data. Can only set when is editing is false.
      • editing boolean -- Indicates that adding samples to the end of the movie is currently allowed. Exporting will set is editing to false if it is not already false.
      • dimensions (r/o) point -- Property required when making a a movie editor. Specifies the height and width of movie to create.
      • compress1Bit (r/o) boolean -- Can the compressor compress to 1 bit data. 2 colors.
      • compress2Bit (r/o) boolean -- Can the compressor compress to 2 bit data. 4 colors.
      • compress4Bit (r/o) boolean -- Can the compressor compress to 4 bit data. 16 colors.
      • compress8Bit (r/o) boolean -- Can the compressor compress to 8 bit data. 256 colors.
      • compress16Bit (r/o) boolean -- Can the compressor compress to 16 bit data.
      • compress32Bit (r/o) boolean -- Can the compressor compress to 32 bit data.
      • compressTemporal (r/o) boolean -- Can the compressor do temporal compression. If a compressor can, then when adding samples, adjacent samples will be compared to see if temporal compression will help to compress the data.
  • graphic exporter -- The export object used to export the graphics. Graphic and window documents create graphic exporters automatically. graphic importers can handle a make new graphics exporter event.
    • Properties:
      • export properties record -- A record of graphic exporter properties that can be set. Allowing you to set multiple properties in one call. This is a write only record, you can obtain all possible information using the other properties.
      • export file location «class furl» -- The location of the file to export to. To export to a new file, specify the folder location and file name.
      • export folder location file specification -- The location of the folder where the graphic will be exported to. A file name will also be required before the graphic can be exported.
      • export file name international text -- The file name that the graphic will be exported as.
      • export file extension (r/o) international text -- The default file name extension for the graphic format the file will be exported as, including the point (.).
      • export file type Unicode text -- Set the graphic format of the file type you want the file to be exported as. All non default settings will need to be reset.
      • export component error integer -- The component error. Possibly indicates that this component may no longer work. Can be cleared (set to 0) if you believe you have fixed the problem.
      • export last operation error integer -- An error code indicating whether the last operation you performed failed or not. If the component error is still 0 then the component will still work.
      • export compression depth integer -- The bit depth that you want to c. Possible values are 1, 2, 4, 8, 16, 24, 32, 33, 34, 36, 40. A bit depth of 33 is black and white, and a bit depth of 40 is 8 bit grayscale.
      • export target data size integer -- The data size the graphic export will try and keep the file size to. JPEG is the only Apple supplied exporter that recognizes this option.
      • export compression quality minimum / low / medium / high / maximum / lossless -- The quality of the produced image that the compressor will aim for when compressing the data.
      • export compression method packbits / not packbits -- Selects whether packbits should be used or not when exporting TIFF files. This option is only relevant if exporting as TIFF. Packbits is not supported if you have enabled exif.
      • export resolution list of small real -- The resolution that the image will be exported as. The horizontal resolution followed by the vertical resolution in dots per inch.
      • export exif data record -- When reading, will return all the of the known exit types of exif data. In this case the record will contain the “exif type” followed by one or two of exif float, exif int, or exif unicode. When writing the int or float will override exif unicode.
      • export exif user data file specification -- Replaces the current exif data of the exporter with the data in the supplied file. You will probably want to do this before setting specific exif type(s). Quicktime will overwrite a few of the exif types when the file is exported. Write only property.
      • export icc profile file specification -- Copy a color profile embedded in the source image file to the exporter. Write only property. Does not take a standalone icc profile file.
      • export exif enabled integer -- Turn on to allow export of exif metadata. The incompatible settings grayscale JPEG and TIFF packbits are disabled when enabled. Enabling thumbnails will also enable exif as creating thumbnails requires exif. 1 = enabled, 0 = not enabled, -1 not supported.
      • export thumbnail state list of integer -- Three integers. When getting this property, the first number is the thumbnail state, -1 indicates that a thumbnail is not possible, 0 indicates not enabled, and 1 indicates that a thumbnail will be created. The following 2 integers are the x and y dims.
      • export custom icon boolean -- Add a custom icon to the image file if true. Default is false.
  • window document -- A graphics document with a window and the added functionality that provides.
  • graphic document -- An offscreen graphics document.
    • Plural name:
      • graphic documents
    • Inherited by:
    • Properties:
      • name international text -- The name of the graphic document object.
      • dimensions (r/o) point -- The dimensions in pixels of the drawing area.
      • alpha channel record -- Set the alpha channel of this document to one of the color channels (or average) of the source graphic document. The alpha channel will be stored in the exported graphic file for TIFF, PNG and JPEG 2000 file types. Write only. See the class alpha transpar
    • Elements:
  • shape -- Required properties are inherited like “class”, bounds rectangle and color. Shapes like, filled rectangle, framed rectangle, filled oval and framed oval require no more properties than those defined by the shape class and the classes it inherits from.
    • Inherits from:
    • Inherited by:
    • Properties:
      • graphics mode blend / add pin / add over / sub pin / transparent / add max / sub over / add min / dither copy / straight alpha / pre white alpha / pre black alpha / composition / alpha blend / pre mul color alpha / alphaAsGray -- The quickdraw graphics mode to draw with.
      • opcolor RGB color -- The OpColor for the quickdraw graphics mode. This property is used for specific graphics modes.
      • drawing type (r/o) quartz / quickdraw -- Specifies whether to use quartz or quickdraw drawing. Quartz will give you anti-aliased drawing. filled arc, framed arc and any text drawing can only be done using quickdraw.
      • opacity (r/o) small real -- The opacity. An optional quartz drawing property only. Quartz drawing ignores graphics mode and opcolor. 1.0 is fully opaque, 0.0 is transparent.
      • line thickness integer -- Optional, default is 1. Used for framed oval, framed rectangle, framed polygon and line drawing or any other framed drawing.
      • start point point -- The start point for line and standard text. Required in those cases, otherwise not used.
  • arc -- Specifies the extra properties required for drawing an arc. A number of other properties defined in the inheritance tree are either required like color and bounds rectangle or optional like line thickness for a framed arc.
    • Inherits from:
    • Properties:
      • start angle integer -- The starting angle that drawing the shapes (frame arc, filled arc) require. 12 o’ clock is 0. 3 o’clock is 90. 45 degrees is through the corner of the rectangle, even if the rectangle is not a square.
      • arc angle integer -- Is how many degrees the arc covers from the start angle. Positive values are in a clockwise direction and negative values are in a anti-clockwise direction.
  • polygon -- Specifies the extra properties required for drawing a polygon as well as the required and optional properties specified in the inheritance tree.
    • Inherits from:
    • Properties:
      • poly points list of point -- The points specifying the individual pixels to be drawn.
  • pixels -- Specifies the extra properties required for drawing pixels as well as the required and optional properties specified in the inheritance tree.
    • Inherits from:
    • Inherited by:
    • Properties:
      • pixel points list of point -- The points specifying the individual pixels to be drawn.
  • multicolored pixels -- Specifies the extra properties required for drawing pixels with different colours as well as the required and optional properties specified in the inheritance tree.
    • Inherits from:
    • Properties:
      • pixel colors list of RGB color -- The color of each individual pixel. The list of colours must be the same length as the list of points and in the same order.
  • text class -- Specifies the extra properties specific to drawing text. A required inherited property is start point. Optional inherited properties are graphics mode, opcolor, color and background color.
    • Inherits from:
    • Properties:
      • font Unicode text -- The font to draw the text with. Relevant to text drawing only. Required.
      • font style plain text / bold / italic / bold plus italic / underline / bold plus underline / italic plus underline / italic plus bold plus underline -- The font style used for drawing text. Defaults to plain text. Optional.
      • font size integer -- The size of the font in points. Required.
      • drawing text Unicode text -- The text to be drawn. Required.
      • rotation integer -- The amount in degrees to rotate the text by. Defaults to 0. Optional.
      • start from (r/o) text baseline / top left / top right / bottom left / bottom right / centre -- The location of the start point relative to the bounding rectangle of the text. Default is text baseline. Optional.
  • line -- Specifies the extra property required for drawing a line. The other line specific property“start point” defined in the base shape abstract class is also required. color is also required, and drawing mode and opacity are optional properties.
    • Inherits from:
    • Inherited by:
    • Properties:
      • end point point -- The end point for line drawing. Required.
  • quartz drawing class -- Properties that allow quartz lines, cubic and quadratic bezier curves to be combined together. Required properties are class, color, start point and quartzrecord. Optional property is
    • Inherits from:
    • Properties:
      • cp1 point -- Control point 1, required for quadratic and cubic bezier curves.
      • cp2 (r/o) point -- Control point 2, required for cubic bezier curves.
      • quartzType (r/o) quartz line / quartz cubic bezier / quartz quadratic bezier -- The type of quartz segment, a line, or a cubic or quadratic bezier curve. Required.
      • quartzRecord (r/o) list of record -- In the composition element, the quartzrecord is a list of records. Each record must contain quartz type, and an end point and if the quartz type is cubic bezier then cp1 and cp2, or if quadratic bezier then cp1.
      • quartzFillType (r/o) winding number / evenOdd -- The quartz drawing fill type, default is winding number. Optional for filled drawing, ignored for framed drawing.
  • filter rgb balance
    • Inherits from:
    • Properties:
      • red factor (r/o) integer -- The amount to change the red color of the image by. Its range is from 0 to 200. Default value is 100. One of the “RGB balance” properties must be set to a non default value for the filter to be applied.
      • green factor (r/o) integer -- The amount to change the green color of the image by. Its range is from 0 to 200. Default value is 100. One of the “RGB balance” properties must be set to a non default value for the filter to be applied.
      • blue factor (r/o) integer -- The amount to change the blue color of the image by. Its range is from 0 to 200. Default value is 100. One of the “RGB balance” properties must be set to a non default value for the filter to be applied.
  • filter detect edges
    • Inherits from:
    • Properties:
      • width of edge (r/o) least / a little / less than average / average / more than average / a lot / most -- Width of the edge. Range is least to most. Default is least.
      • colorize (r/o) integer -- Whether to colorize the image. Range is 1 (yes) or 0 (no). Default is 0.
  • filter emboss
    • Inherits from:
    • Properties:
      • amount to emboss (r/o) least / a little / less than average / average / more than average / a lot / most -- The amount of embossing to be applied to the image. Range is least to most. Default is least. A property of the “embossing” filter type.
  • filter sharpen
    • Inherits from:
    • Properties:
      • amount to sharpen (r/o) least / a little / less than average / average / more than average / a lot / most -- The amount of sharpening. The range is from least to most. Default is least.
  • filter color style
    • Inherits from:
    • Properties:
      • solarize amount (r/o) integer -- The amount to solarize the image by. The range is from 0 to 8. Default is 0. One of the “color style” properties must be set to a non default value for the filter to be applied.
      • solarize point (r/o) integer -- The solarize point. The range is from 0 to 255. The default is 128. One of the “color style” properties must be set to a non default value for the filter to be applied.
      • posterize amount (r/o) integer -- The amount to posterize the image by. The range is from 0 to 32. The default is 0. A property of the “color style” filter type. One of the “color style” properties must be set to a non default value for the filter to be applied.
  • filter brightness and contrast
    • Inherits from:
    • Inherited by:
    • Properties:
      • brightness (r/o) integer -- The amount to increase or reduce brightness. Range is from -100 to 100. Default is 0. A property of the “brightness and contrast” and the “color tint” filter types.
      • contrast (r/o) integer -- The amount to increase or reduce the contrast. Range is -100 to 100. Default is 0. A property of the “brightness and contrast” and the “color tint” filter types.
  • filter color tint -- The “color tint” filter. If the tint type is “other” then “color”, “background color”, “contrast” and “brightness” all become optional properties, though at least one is required.
    • Inherits from:
    • Properties:
      • tint amount (r/o) small real -- The percentage of the tint to apply. Its range is from 0.0 to 100.0. Default is 100.0.
      • tint type black and white / x ray / sepia / cobalt / other -- The tint type. If the tint type is black and white, sepia, cobalt or x-ray no further tint properties are required, though tint amount can be specified. If the tint type is other, then one of color, background color, brightness, or contrast is required.
  • filter color sync
    • Inherits from:
    • Properties:
      • source profile name (r/o) international text -- The name of the source color profile.
      • destination profile name (r/o) international text -- The name of the destination color profile in the Library/Colorsync folder.
      • matching option (r/o) perceptual photos / relative colorimetric logos / saturation graphics / absolute colorimetric logos -- The method for applying the color sync profiles.
  • filter HSL balance
    • Inherits from:
    • Properties:
      • hue factor (r/o) integer -- The amount to change the color hue by. Its range is from -60 to 60. Default is 0. One of the “HSL balance” properties must be set to a non default value for the “HSL balance” to be applied.
      • saturation factor (r/o) integer -- The amount to saturate the image by. Its range is from 0 to 200. Default value is 100. A property of the “HSL balance” filter type. One of the “HSL balance” properties must be set to a non default value for the “HSL balance” to be applied.
      • lightness factor (r/o) integer -- The amount to change the lightness of the image by. Its range is from 0 to 200. Default value is 100. A property of the “HSL balance” filter type. One of the “HSL balance” properties must be set to a non default value for the “HSL balance” to be applied.
  • filter blur
    • Inherits from:
    • Properties:
      • blur amount least / a little / less than average / average / more than average / a lot / most -- The amount of blurring. Range is from least to most. Default is average.
  • filter alpha gain
    • Inherits from:
    • Properties:
      • bottom pin (r/o) integer -- The base level for the alpha channel below which it can’t be set. Its range is from 0 to top pin. Default is 0. The alpha gain filter type requires at least one of its properties to be set to a non default value.
      • top pin (r/o) integer -- The top level over which the the alpha channel can not be set. Its range is from bottom pin to 255. Default is 255.
      • gain (r/o) small real -- The gain for the alpha gain. Range is from 0.0 to 100.0. Default is 1.00.
      • offset (r/o) integer -- The offset for the alpha gain. Its range is from 0 to 255. Default is 0.
  • filter centre gradient -- A filter that performs a gradient lightening or darkening.
    • Inherits from:
    • Properties:
      • vertical brightening (r/o) integer -- The vertical brightening expressed as a percentage of the original brightness. Range is from -100 to 100, default is 0. Negative values darken the image.
      • vertical distance (r/o) integer -- The vertical distance from the centre to the edge from which brightening starts, as a percentage. Range is from 0 to 100, default is 50. The edge is the border of the image or the bounds rectangle if set.
      • horizontal brightening (r/o) integer -- The horizontal brightening expressed as a percentage of the original brightness. Range is from -100 to 100, default is 0. Negative values darken the image.
      • horizontal distance (r/o) integer -- The horizontal distance from the centre to the edge from which the brightening starts, as a percentage. Range is from 0 to 100, default is 50. The edge is the border of the image or the bounds rectangle if set.
  • pixel values -- A class to define the terms necessary to read pixel values.
    • Inherits from:
    • Properties:
      • pixel value class (r/o) pixels at points / pixels on line / pixels in rectangle / pixels in polygon / pixels in oval -- The shape from which to obtain all the pixel values.
      • pixel points list of point -- The points specifying the locations from which to read the pixel values from. Only required if pixels at points is specified in pixel value class.
  • bad pixels -- A class to define the terms necessary to create rules for detecting bad pixels. The bounds rectangle property can also be used to restrict the area that you want to search for bad pixels in.
    • Inherits from:
    • Properties:
      • adjacent to (r/o) integer -- The number of pixels adjacent to the pixel being considered that have to different by more than the amount specified by the property different by.
      • different by (r/o) integer -- The amount (between 0 and 65535) by which adjacent pixels have to be different by for a pixel to be considered bad.
      • color channels (r/o) average of / all channels / any channel / red channel / green channel / blue channel -- The color channels to be considered when searching for bad pixels. Default value is any channel.
  • bilinear interpolate -- This composition element takes a list of rectangles (bounds rectangles) that define the areas where bilinear interpolation will occur.
    • Properties:
      • bounds rectangles list of bounding rectangle -- A list of rectangles specifying each area where bilinear interpolation will occur. The border of the rectangle contains the data that the interpolation will use, the inside of the rectange will have its data replaced with the interpolated results.