Home » Archimedes archive » Acorn User » AU 1998-02 A.adf » PDScheme » ArtToSpr/!ArtToSpr/!Help

ArtToSpr/!ArtToSpr/!Help

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Acorn User » AU 1998-02 A.adf » PDScheme
Filename: ArtToSpr/!ArtToSpr/!Help
Read OK:
File size: 0816 bytes
Load address: 0000
Exec address: 0000
File contents
ArtToSpr
________

Purpose: Create sprites from Artworks and Draw files
Author:  Tony Houghton <tonyh@tcp.co.uk>
Version: 1.01 (3 December 1997)

Requirements
____________

RISC OS 3.1 or later
2MB or greater
Toolbox and Drawfile modules
Artworks modules (in AWViewer)

Special features/advantages
___________________________

Full control over scaling and rotation of source picture.


Instructions
____________

ArtToSpr is quite simple, so this Help file won't describe it in detail. Use
Interactive Help (!Help in your Apps folder) to find the purpose of any icon
or window.

Having said that, there are a few points that would benefit from further
explanation:

Units
-----
Dimensions in output options are given in OS units, but the size of the
sprite in the info window is given in pixels.

Scaling in conjunction with rotation
------------------------------------
Scaling always takes place after rotation, which may need to be borne in mind
when combining a rotation with inequal horizontal and vertical scale factors.

Aspect ratios
-------------
When a picture is scaled to fit a sprite of a given size it may need to be
scaled by different horizontal and vertical factors to achieve a perfect fit
(see also previous paragraph). To avoid this distortion, you can click
"Preserve aspect ratio". This will mean that the picture will probably only
fit the sprite in one direction, leaving some wasted rows or columns in the
sprite; there are 3 options for dealing with this:

Edge -   Plots the picture at the bottom/left of the sprite, leaving the
         blank rows at top or right.

Centre - Plots the picture in the middle of the sprite, leaving an equal
         amount of blank space at each edge.

Trim -   Removes the blank rows or columns, leaving the sprite smaller than
         specified in one direction.


Author's addresses
__________________

Tony Houghton
271 Upper Weston Lane
Woolston
Southampton
SO19 9HY

Email:   tonyh@tcp.co.uk
WWW:     http://homepages.tcp.co.uk/~tonyh/

Licence
_______

This version is copyright Acorn User/IDG Media.
00000000  41 72 74 54 6f 53 70 72  0a 5f 5f 5f 5f 5f 5f 5f  |ArtToSpr._______|
00000010  5f 0a 0a 50 75 72 70 6f  73 65 3a 20 43 72 65 61  |_..Purpose: Crea|
00000020  74 65 20 73 70 72 69 74  65 73 20 66 72 6f 6d 20  |te sprites from |
00000030  41 72 74 77 6f 72 6b 73  20 61 6e 64 20 44 72 61  |Artworks and Dra|
00000040  77 20 66 69 6c 65 73 0a  41 75 74 68 6f 72 3a 20  |w files.Author: |
00000050  20 54 6f 6e 79 20 48 6f  75 67 68 74 6f 6e 20 3c  | Tony Houghton <|
00000060  74 6f 6e 79 68 40 74 63  70 2e 63 6f 2e 75 6b 3e  |tonyh@tcp.co.uk>|
00000070  0a 56 65 72 73 69 6f 6e  3a 20 31 2e 30 31 20 28  |.Version: 1.01 (|
00000080  33 20 44 65 63 65 6d 62  65 72 20 31 39 39 37 29  |3 December 1997)|
00000090  0a 0a 52 65 71 75 69 72  65 6d 65 6e 74 73 0a 5f  |..Requirements._|
000000a0  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 5f 0a 0a 52 49 53  |___________..RIS|
000000b0  43 20 4f 53 20 33 2e 31  20 6f 72 20 6c 61 74 65  |C OS 3.1 or late|
000000c0  72 0a 32 4d 42 20 6f 72  20 67 72 65 61 74 65 72  |r.2MB or greater|
000000d0  0a 54 6f 6f 6c 62 6f 78  20 61 6e 64 20 44 72 61  |.Toolbox and Dra|
000000e0  77 66 69 6c 65 20 6d 6f  64 75 6c 65 73 0a 41 72  |wfile modules.Ar|
000000f0  74 77 6f 72 6b 73 20 6d  6f 64 75 6c 65 73 20 28  |tworks modules (|
00000100  69 6e 20 41 57 56 69 65  77 65 72 29 0a 0a 53 70  |in AWViewer)..Sp|
00000110  65 63 69 61 6c 20 66 65  61 74 75 72 65 73 2f 61  |ecial features/a|
00000120  64 76 61 6e 74 61 67 65  73 0a 5f 5f 5f 5f 5f 5f  |dvantages.______|
00000130  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 5f 5f 5f 5f 5f 5f  |________________|
00000140  5f 5f 5f 5f 5f 0a 0a 46  75 6c 6c 20 63 6f 6e 74  |_____..Full cont|
00000150  72 6f 6c 20 6f 76 65 72  20 73 63 61 6c 69 6e 67  |rol over scaling|
00000160  20 61 6e 64 20 72 6f 74  61 74 69 6f 6e 20 6f 66  | and rotation of|
00000170  20 73 6f 75 72 63 65 20  70 69 63 74 75 72 65 2e  | source picture.|
00000180  0a 0a 0a 49 6e 73 74 72  75 63 74 69 6f 6e 73 0a  |...Instructions.|
00000190  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 5f 5f 0a 0a 41 72  |____________..Ar|
000001a0  74 54 6f 53 70 72 20 69  73 20 71 75 69 74 65 20  |tToSpr is quite |
000001b0  73 69 6d 70 6c 65 2c 20  73 6f 20 74 68 69 73 20  |simple, so this |
000001c0  48 65 6c 70 20 66 69 6c  65 20 77 6f 6e 27 74 20  |Help file won't |
000001d0  64 65 73 63 72 69 62 65  20 69 74 20 69 6e 20 64  |describe it in d|
000001e0  65 74 61 69 6c 2e 20 55  73 65 0a 49 6e 74 65 72  |etail. Use.Inter|
000001f0  61 63 74 69 76 65 20 48  65 6c 70 20 28 21 48 65  |active Help (!He|
00000200  6c 70 20 69 6e 20 79 6f  75 72 20 41 70 70 73 20  |lp in your Apps |
00000210  66 6f 6c 64 65 72 29 20  74 6f 20 66 69 6e 64 20  |folder) to find |
00000220  74 68 65 20 70 75 72 70  6f 73 65 20 6f 66 20 61  |the purpose of a|
00000230  6e 79 20 69 63 6f 6e 0a  6f 72 20 77 69 6e 64 6f  |ny icon.or windo|
00000240  77 2e 0a 0a 48 61 76 69  6e 67 20 73 61 69 64 20  |w...Having said |
00000250  74 68 61 74 2c 20 74 68  65 72 65 20 61 72 65 20  |that, there are |
00000260  61 20 66 65 77 20 70 6f  69 6e 74 73 20 74 68 61  |a few points tha|
00000270  74 20 77 6f 75 6c 64 20  62 65 6e 65 66 69 74 20  |t would benefit |
00000280  66 72 6f 6d 20 66 75 72  74 68 65 72 0a 65 78 70  |from further.exp|
00000290  6c 61 6e 61 74 69 6f 6e  3a 0a 0a 55 6e 69 74 73  |lanation:..Units|
000002a0  0a 2d 2d 2d 2d 2d 0a 44  69 6d 65 6e 73 69 6f 6e  |.-----.Dimension|
000002b0  73 20 69 6e 20 6f 75 74  70 75 74 20 6f 70 74 69  |s in output opti|
000002c0  6f 6e 73 20 61 72 65 20  67 69 76 65 6e 20 69 6e  |ons are given in|
000002d0  20 4f 53 20 75 6e 69 74  73 2c 20 62 75 74 20 74  | OS units, but t|
000002e0  68 65 20 73 69 7a 65 20  6f 66 20 74 68 65 0a 73  |he size of the.s|
000002f0  70 72 69 74 65 20 69 6e  20 74 68 65 20 69 6e 66  |prite in the inf|
00000300  6f 20 77 69 6e 64 6f 77  20 69 73 20 67 69 76 65  |o window is give|
00000310  6e 20 69 6e 20 70 69 78  65 6c 73 2e 0a 0a 53 63  |n in pixels...Sc|
00000320  61 6c 69 6e 67 20 69 6e  20 63 6f 6e 6a 75 6e 63  |aling in conjunc|
00000330  74 69 6f 6e 20 77 69 74  68 20 72 6f 74 61 74 69  |tion with rotati|
00000340  6f 6e 0a 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |on.-------------|
00000350  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
00000360  2d 2d 2d 2d 2d 2d 2d 0a  53 63 61 6c 69 6e 67 20  |-------.Scaling |
00000370  61 6c 77 61 79 73 20 74  61 6b 65 73 20 70 6c 61  |always takes pla|
00000380  63 65 20 61 66 74 65 72  20 72 6f 74 61 74 69 6f  |ce after rotatio|
00000390  6e 2c 20 77 68 69 63 68  20 6d 61 79 20 6e 65 65  |n, which may nee|
000003a0  64 20 74 6f 20 62 65 20  62 6f 72 6e 65 20 69 6e  |d to be borne in|
000003b0  20 6d 69 6e 64 0a 77 68  65 6e 20 63 6f 6d 62 69  | mind.when combi|
000003c0  6e 69 6e 67 20 61 20 72  6f 74 61 74 69 6f 6e 20  |ning a rotation |
000003d0  77 69 74 68 20 69 6e 65  71 75 61 6c 20 68 6f 72  |with inequal hor|
000003e0  69 7a 6f 6e 74 61 6c 20  61 6e 64 20 76 65 72 74  |izontal and vert|
000003f0  69 63 61 6c 20 73 63 61  6c 65 20 66 61 63 74 6f  |ical scale facto|
00000400  72 73 2e 0a 0a 41 73 70  65 63 74 20 72 61 74 69  |rs...Aspect rati|
00000410  6f 73 0a 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |os.-------------|
00000420  0a 57 68 65 6e 20 61 20  70 69 63 74 75 72 65 20  |.When a picture |
00000430  69 73 20 73 63 61 6c 65  64 20 74 6f 20 66 69 74  |is scaled to fit|
00000440  20 61 20 73 70 72 69 74  65 20 6f 66 20 61 20 67  | a sprite of a g|
00000450  69 76 65 6e 20 73 69 7a  65 20 69 74 20 6d 61 79  |iven size it may|
00000460  20 6e 65 65 64 20 74 6f  20 62 65 0a 73 63 61 6c  | need to be.scal|
00000470  65 64 20 62 79 20 64 69  66 66 65 72 65 6e 74 20  |ed by different |
00000480  68 6f 72 69 7a 6f 6e 74  61 6c 20 61 6e 64 20 76  |horizontal and v|
00000490  65 72 74 69 63 61 6c 20  66 61 63 74 6f 72 73 20  |ertical factors |
000004a0  74 6f 20 61 63 68 69 65  76 65 20 61 20 70 65 72  |to achieve a per|
000004b0  66 65 63 74 20 66 69 74  0a 28 73 65 65 20 61 6c  |fect fit.(see al|
000004c0  73 6f 20 70 72 65 76 69  6f 75 73 20 70 61 72 61  |so previous para|
000004d0  67 72 61 70 68 29 2e 20  54 6f 20 61 76 6f 69 64  |graph). To avoid|
000004e0  20 74 68 69 73 20 64 69  73 74 6f 72 74 69 6f 6e  | this distortion|
000004f0  2c 20 79 6f 75 20 63 61  6e 20 63 6c 69 63 6b 0a  |, you can click.|
00000500  22 50 72 65 73 65 72 76  65 20 61 73 70 65 63 74  |"Preserve aspect|
00000510  20 72 61 74 69 6f 22 2e  20 54 68 69 73 20 77 69  | ratio". This wi|
00000520  6c 6c 20 6d 65 61 6e 20  74 68 61 74 20 74 68 65  |ll mean that the|
00000530  20 70 69 63 74 75 72 65  20 77 69 6c 6c 20 70 72  | picture will pr|
00000540  6f 62 61 62 6c 79 20 6f  6e 6c 79 0a 66 69 74 20  |obably only.fit |
00000550  74 68 65 20 73 70 72 69  74 65 20 69 6e 20 6f 6e  |the sprite in on|
00000560  65 20 64 69 72 65 63 74  69 6f 6e 2c 20 6c 65 61  |e direction, lea|
00000570  76 69 6e 67 20 73 6f 6d  65 20 77 61 73 74 65 64  |ving some wasted|
00000580  20 72 6f 77 73 20 6f 72  20 63 6f 6c 75 6d 6e 73  | rows or columns|
00000590  20 69 6e 20 74 68 65 0a  73 70 72 69 74 65 3b 20  | in the.sprite; |
000005a0  74 68 65 72 65 20 61 72  65 20 33 20 6f 70 74 69  |there are 3 opti|
000005b0  6f 6e 73 20 66 6f 72 20  64 65 61 6c 69 6e 67 20  |ons for dealing |
000005c0  77 69 74 68 20 74 68 69  73 3a 0a 0a 45 64 67 65  |with this:..Edge|
000005d0  20 2d 20 20 20 50 6c 6f  74 73 20 74 68 65 20 70  | -   Plots the p|
000005e0  69 63 74 75 72 65 20 61  74 20 74 68 65 20 62 6f  |icture at the bo|
000005f0  74 74 6f 6d 2f 6c 65 66  74 20 6f 66 20 74 68 65  |ttom/left of the|
00000600  20 73 70 72 69 74 65 2c  20 6c 65 61 76 69 6e 67  | sprite, leaving|
00000610  20 74 68 65 0a 20 20 20  20 20 20 20 20 20 62 6c  | the.         bl|
00000620  61 6e 6b 20 72 6f 77 73  20 61 74 20 74 6f 70 20  |ank rows at top |
00000630  6f 72 20 72 69 67 68 74  2e 0a 0a 43 65 6e 74 72  |or right...Centr|
00000640  65 20 2d 20 50 6c 6f 74  73 20 74 68 65 20 70 69  |e - Plots the pi|
00000650  63 74 75 72 65 20 69 6e  20 74 68 65 20 6d 69 64  |cture in the mid|
00000660  64 6c 65 20 6f 66 20 74  68 65 20 73 70 72 69 74  |dle of the sprit|
00000670  65 2c 20 6c 65 61 76 69  6e 67 20 61 6e 20 65 71  |e, leaving an eq|
00000680  75 61 6c 0a 20 20 20 20  20 20 20 20 20 61 6d 6f  |ual.         amo|
00000690  75 6e 74 20 6f 66 20 62  6c 61 6e 6b 20 73 70 61  |unt of blank spa|
000006a0  63 65 20 61 74 20 65 61  63 68 20 65 64 67 65 2e  |ce at each edge.|
000006b0  0a 0a 54 72 69 6d 20 2d  20 20 20 52 65 6d 6f 76  |..Trim -   Remov|
000006c0  65 73 20 74 68 65 20 62  6c 61 6e 6b 20 72 6f 77  |es the blank row|
000006d0  73 20 6f 72 20 63 6f 6c  75 6d 6e 73 2c 20 6c 65  |s or columns, le|
000006e0  61 76 69 6e 67 20 74 68  65 20 73 70 72 69 74 65  |aving the sprite|
000006f0  20 73 6d 61 6c 6c 65 72  20 74 68 61 6e 0a 20 20  | smaller than.  |
00000700  20 20 20 20 20 20 20 73  70 65 63 69 66 69 65 64  |       specified|
00000710  20 69 6e 20 6f 6e 65 20  64 69 72 65 63 74 69 6f  | in one directio|
00000720  6e 2e 0a 0a 0a 41 75 74  68 6f 72 27 73 20 61 64  |n....Author's ad|
00000730  64 72 65 73 73 65 73 0a  5f 5f 5f 5f 5f 5f 5f 5f  |dresses.________|
00000740  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 0a 0a 54 6f 6e 79  |__________..Tony|
00000750  20 48 6f 75 67 68 74 6f  6e 0a 32 37 31 20 55 70  | Houghton.271 Up|
00000760  70 65 72 20 57 65 73 74  6f 6e 20 4c 61 6e 65 0a  |per Weston Lane.|
00000770  57 6f 6f 6c 73 74 6f 6e  0a 53 6f 75 74 68 61 6d  |Woolston.Southam|
00000780  70 74 6f 6e 0a 53 4f 31  39 20 39 48 59 0a 0a 45  |pton.SO19 9HY..E|
00000790  6d 61 69 6c 3a 20 20 20  74 6f 6e 79 68 40 74 63  |mail:   tonyh@tc|
000007a0  70 2e 63 6f 2e 75 6b 0a  57 57 57 3a 20 20 20 20  |p.co.uk.WWW:    |
000007b0  20 68 74 74 70 3a 2f 2f  68 6f 6d 65 70 61 67 65  | http://homepage|
000007c0  73 2e 74 63 70 2e 63 6f  2e 75 6b 2f 7e 74 6f 6e  |s.tcp.co.uk/~ton|
000007d0  79 68 2f 0a 0a 4c 69 63  65 6e 63 65 0a 5f 5f 5f  |yh/..Licence.___|
000007e0  5f 5f 5f 5f 0a 0a 54 68  69 73 20 76 65 72 73 69  |____..This versi|
000007f0  6f 6e 20 69 73 20 63 6f  70 79 72 69 67 68 74 20  |on is copyright |
00000800  41 63 6f 72 6e 20 55 73  65 72 2f 49 44 47 20 4d  |Acorn User/IDG M|
00000810  65 64 69 61 2e 0a                                 |edia..|
00000816