home *** CD-ROM | disk | FTP | other *** search
/ Painter Bear's Language Bridge — Italian / Bridge_ponte_itialian.iso / pc / xtras / -pmatic.dir / docs_13.txt < prev    next >
Encoding:
Text File  |  1999-09-22  |  2.8 KB  |  65 lines
  1. Miscellaneous Routines
  2.  
  3. The following commands are odds and ends that didn't fit any other category:
  4.  
  5.     hideMessages        hides the PrintOMatic Xtra's error alerts
  6.     setPageNumSymbol    sets the page numbering substitution symbol
  7.     register            registers your copy of the PrintOMatic Xtra
  8.     setLowMemLimits     sets the Xtra's low-memory limits
  9.     
  10.  
  11. hideMessages
  12.  
  13. Syntax:    hideMessages document, trueOrFalse
  14.  
  15. The hideMessages command will prevent PrintOMatic from displaying alert dialogs when something goes wrong. You should strive to make your code solid enough so PrintOMatic will never have to display an error alert (without invoking this command). But if you need to suppress the messages, you can do it here.
  16.  
  17.  
  18. setPageNumSymbol
  19.  
  20. Syntax:    setPageNumSymbol document, symbol
  21.  
  22. The setPageNumSymbol command selects a text symbol whose every occurrence in the document will be replaced with the current page number at printing time. This lets you number your pages by including a text element on the master page containing the symbol you define for page numbering. Call setPageNumSymbol with a value of "" (an empty string) to turn off this feature.
  23.  
  24.  
  25. getVersion
  26.  
  27. Syntax:    getVersion(xtra "PrintOMatic ")
  28.  
  29. Returns:   the version number of the Xtra, in string form
  30.  
  31. This function returns the version number of the xtra.
  32.  
  33. Example:
  34.  
  35.     set version = getVersion(xtra "PrintOMatic")
  36.     if version <> "1.5.8" then alert "Incompatible Xtra version."
  37.  
  38.  
  39. register
  40.  
  41. Syntax:    register(xtra "PrintOMatic", serialNumber)
  42.  
  43. Returns:   TRUE if the serial number is valid
  44.  
  45. The register command will register the PrintOMatic Xtra, once you license PrintOMatic and obtain a valid serial number. This will enable the methods for fully customizing your print job, such as setProgressMsg and setProgressPict. It will also remove those annoying "unregistered copy" messages from your print progress dialog and printed output.
  46.  
  47. The registration process only registers your copy of PrintOMatic temporarily. Your serial number is stored in Director's registry and might not be stored for any longer than the current Director session. If you re-install Director, move your movie to another computer, or use PrintOMatic from a Projector, the serial number will likely be unavailable the next time you use PrintOMatic.
  48.  
  49. Therefore, you should add the registration code below to the startMovie handler of every movie that uses the PrintOMatic Xtra. This will ensure that PrintOMatic can always find its serial number when it needs to.
  50.  
  51. Example:
  52.  
  53. The following code registers your copy of the PrintOMatic Xtra for the duration of the current Director session:
  54.  
  55.     register(xtra "PrintOMatic", "<your serial number>")
  56.  
  57.  
  58. setLowMemLimits
  59.  
  60. Syntax:    setLowMemLimits document, globalHeap, localHeap
  61.  
  62. This feature is not yet implemented in the current version of the PrintOMatic Xtra.
  63.  
  64.  
  65.