×
Create a new article
Write your page title here:
We currently have 133 articles on Open Eggbert. Type your article name above or click on one of the titles below and start writing!



Open Eggbert
Open Eggbert
133Articles

Sprite Utils: Difference between revisions

VisualWikitext
No edit summary
No edit summary
 
(13 intermediate revisions by the same user not shown)
Line 37: Line 37:
|Number of the row in the images to be drawn (since row 1)
|Number of the row in the images to be drawn (since row 1)
|-
|-
|'''--file-name'''
|No
|All files in the sprite sheet
|draw
|Name of the image file to be drawn
|-
|'''--draw-number'''
|No
|Yes
|draw
|Draws the numbers of the sprites in the image
|-
|'''--double-sized-number'''
|No
|No
|draw
|Draws the number label in the doubled size
|}
== Commands ==
=== Command: draw ===
Rectangles are drawn around the sprites and each sprite is labeled with its number. in the image
'''Example:'''
<pre>
java -jar /rv/data/desktop/code/github.com/openeggbert/sprite-utils/target/sprite-utils-0.0.0-SNAPSHOT-jar-with-dependencies.jar \
draw \
--dir /rv/data/desktop/code/github.com/openeggbert/open-eggbert-legacy-assets/speedy_eggbert_1/IMAGE08  \
--rectangle-color 255,0,0  \
--sprite-sheet-path /rv/data/desktop/code/github.com/openeggbert/open-eggbert/assets/default-spritesheets/speedy_blupi_I.spritesheet.csv  \
--row 5 \
--file-name OBJECT.BLP \
--double-sized-number true
</pre>
== Format of CSV file spritesheet.csv ==
'''Note:''' The file *spritesheet.csv.computed.csv is intended to be used in Open Eggbert - for image mods
=== Columns ===
{| class="wikitable"
|+
!Column name
!Mandatory
!Description
|-
|'''File'''
|Yes
|Name of the image, where the sprite exists.
|-
|'''Group'''
|Yes
|Sprite group name.
|-
|'''Number in Group'''
|Yes
|Number in group.
|-
|'''Row'''
|Yes
|Row position of sprite in the image starting from 1.
|-
|'''Column'''
|Yes
|Column position of sprite in the row of the image starting from 1
|-
|'''X'''
|No
|Start x position of the sprite starting from 0 and starting from the top-left corner. If the value is empty, then the X value is calculated automatically.
|-
|'''Y'''
|Yes
|Start y position of the sprite starting from 0 and starting from the top-left corner. The value cannot be empty.
|-
|'''Width'''
|Yes
|Width of the sprite.
|-
|'''Height'''
|Yes for 1st column
|Height of the sprite. If the number of column is larger than 1 and the height is greater, than the height of the previous column, than the height is interpreted as an addition to the height of the previous sprite.
|-
|'''Notes'''
|No
|Notes
|-
|'''Tags'''
|No
|Tags
|-
|'''Number per file'''
|Yes
|Number of sprite in the image file
|}
=== Example ===
{| class="wikitable"
|'''File'''
|'''Group'''
|'''Number in Group'''
|'''Row'''
|'''Column'''
|'''X'''
|'''Y'''
|'''Width'''
|'''Height'''
|'''Notes'''
|'''Tags'''
|'''Number per file'''
|-
|blupi000.blp
|Yellow_Eggbert_Born
|1
|1
|1
|
|0
|28
|20
|
|ok
|1
|-
|blupi000.blp
|Yellow_Eggbert_Born
|2
|1
|2
|
|0
|28
|0
|
|ok
|2
|-
|blupi000.blp
|Yellow_Eggbert_Born
|3
|1
|3
|
|0
|28
|3
|
|ok
|3
|-
|blupi000.blp
|Yellow_Eggbert_Born
|4
|1
|4
|
|0
|28
|0
|
|ok
|4
|-
|blupi000.blp
|Yellow Bomb
|1
|1
|5
|
|0
|34
|1
|
|ok
|5
|-
|blupi000.blp
|Yellow Bomb
|2
|1
|6
|
|0
|38
|0
|
|ok
|6
|-
|blupi000.blp
|Yellow Bomb
|3
|1
|7
|
|0
|40
|0
|
|ok
|7
|-
|blupi000.blp
|Yellow Bomb
|4
|1
|8
|
|0
|42
|0
|
|ok
|8
|-
|blupi000.blp
|Yellow Bomb
|5
|1
|9
|
|0
|44
|0
|
|ok
|9
|-
|blupi000.blp
|Yellow Bomb
|6
|1
|10
|
|0
|45
|0
|
|ok
|10
|-
|blupi000.blp
|Yellow_Eggbert_Life
|1
|1
|11
|
|0
|17
|1
|
|ok
|11
|-
|blupi000.blp
|Yellow_Eggbert_Born
|5
|1
|12
|
|0
|28
|2
|
|ok
|12
|-
|blupi000.blp
|Yellow_Eggbert_Born
|6
|1
|13
|
|0
|28
|2
|
|ok
|13
|-
|blupi000.blp
|Yellow_Eggbert_Born
|7
|1
|14
|
|0
|28
|1
|
|ok
|14
|-
|blupi000.blp
|Yellow_Eggbert_Born
|8
|1
|15
|
|0
|28
|1
|
|ok
|15
|-
|blupi000.blp
|Yellow_Eggbert_Swimming_Right
|1
|1
|16
|
|0
|53
|0
|
|ok
|16
|-
|blupi000.blp
|Yellow_Eggbert_Swimming_Left
|1
|1
|17
|
|0
|60
|0
|
|ok
|17
|-
|blupi000.blp
|Yellow_Eggbert_Born
|9
|1
|18
|
|0
|28
|1
|
|ok
|18
|-
|blupi000.blp
|Yellow_Eggbert_Swimming_Left
|2
|1
|19
|
|0
|46
|0
|
|ok
|19
|-
|blupi000.blp
|Yellow_Eggbert_Swimming_Left
|3
|1
|20
|
|0
|46
|0
|
|ok
|20
|-
|blupi000.blp
|Yellow_Eggbert_Swimming_Right
|2
|1
|21
|
|0
|47
|0
|
|ok
|21
|-
|blupi000.blp
|Yellow_Eggbert_Swimming_Right
|3
|2
|1
|
|
|32
|47
|32
|
|
|ok
|22
|-
|blupi000.blp
|Yellow_Eggbert_Swimming_Left
|4
|2
|2
|
|
|32
|47
|0
|
|
|ok
|23
|-
|blupi000.blp
|Yellow_Eggbert_Swimming_Right
|4
|2
|3
|
|
|32
|48
|0
|
|ok
|24
|-
|-
|blupi000.blp
|Yellow_Eggbert_Swimming_Right
|5
|2
|4
|
|
|32
|48
|0
|
|
|ok
|25
|-
|blupi000.blp
|Yellow_Eggbert_Swimming_Left
|5
|2
|5
|
|
|32
|48
|0
|
|
|ok
|26
|-
|blupi000.blp
|Yellow_Eggbert_Swimming_Left
|6
|2
|6
|
|
|32
|48
|0
|
|ok
|27
|-
|-
|blupi000.blp
|Yellow_Eggbert_Swimming_Right
|6
|2
|7
|
|32
|49
|0
|
|
|ok
|28
|-
|blupi000.blp
|Yellow_Eggbert_Swimming_Right
|7
|2
|8
|
|
|32
|49
|0
|
|
|ok
|29
|-
|blupi000.blp
|Yellow_Eggbert_Swimming_Left
|7
|2
|9
|
|
|32
|49
|0
|
|
|ok
|30
|-
|blupi000.blp
|Yellow_Eggbert_Swimming_Right
|8
|2
|10
|
|32
|49
|0
|
|ok
|31
|-
|blupi000.blp
|Yellow_Eggbert_Swimming_Butt
|1
|2
|11
|
|32
|52
|0
|
|ok
|32
|-
|blupi000.blp
|Yellow_Eggbert_Swimming_Left
|8
|2
|12
|
|32
|54
|0
|
|ok
|33
|-
|blupi000.blp
|Yellow_Eggbert_Swimming_Right
|9
|2
|13
|
|32
|57
|0
|
|ok
|34
|-
|blupi000.blp
|Yellow_Eggbert_Swimming_Left
|9
|2
|14
|
|32
|58
|0
|
|ok
|35
|-
|blupi000.blp
|Yellow_Eggbert_Crouching_Left
|1
|2
|15
|
|32
|37
|7
|
|ok
|36
|-
|blupi000.blp
|Yellow_Eggbert_Crouching_Right
|1
|2
|16
|
|32
|37
|0
|
|ok
|37
|}
|}
== Commands ==
=== Command: draw ===
Rectangles are drawn around the sprites and each sprite is labeled with its number. in the image
'''Example:'''
<pre>
java -jar /rv/data/desktop/code/code.nanoboot.org/nanoboot/sprite-utils/target/sprite-utils-0.0.0-SNAPSHOT-jar-with-dependencies.jar \
draw \
--dir /rv/data/desktop/code/code.nanoboot.org/nanoboot/open-eggbert-legacy-assets/speedy_eggbert_1/IMAGE08  \
--rectangle-color 255,0,0  \
--sprite-sheet-path /rv/data/desktop/code/code.nanoboot.org/nanoboot/open-eggbert/assets/default-spritesheets/speedy_blupi_I.spritesheet.csv  \
--row 5 \
--file-name OBJECT.BLP \
--double-sized-number true
</pre>

Latest revision as of 09:13, 31 August 2024

Sprite Utils is a Java application used to manage sprite positions in images.

  • Sprite positions are saved in spritesheet.csv

Syntax: java -jar sprite-utils.jar command --option1 valueOfOption1 --option2 valueOfOption2 ... --optionN valueOfOptionN

Options

Option name Mandatory Default value Command Description
--dir Yes N/A draw Absolute path to the directory with images, which includes sprites
--rectangle-color No 0,255,0 draw Border color of rectangles - comma separated list of RGB (bytes)
--sprite-sheet-path Yes N/A draw Absolute path to the CSV file with the sprite sheet positions
--row No All rows draw Number of the row in the images to be drawn (since row 1)
--file-name No All files in the sprite sheet draw Name of the image file to be drawn
--draw-number No Yes draw Draws the numbers of the sprites in the image
--double-sized-number No No draw Draws the number label in the doubled size

Commands

Command: draw

Rectangles are drawn around the sprites and each sprite is labeled with its number. in the image

Example: 

java -jar /rv/data/desktop/code/github.com/openeggbert/sprite-utils/target/sprite-utils-0.0.0-SNAPSHOT-jar-with-dependencies.jar \
draw \
--dir /rv/data/desktop/code/github.com/openeggbert/open-eggbert-legacy-assets/speedy_eggbert_1/IMAGE08  \
--rectangle-color 255,0,0  \
--sprite-sheet-path /rv/data/desktop/code/github.com/openeggbert/open-eggbert/assets/default-spritesheets/speedy_blupi_I.spritesheet.csv  \
--row 5 \
--file-name OBJECT.BLP \
--double-sized-number true

Format of CSV file spritesheet.csv

Note: The file *spritesheet.csv.computed.csv is intended to be used in Open Eggbert - for image mods

Columns

Column name Mandatory Description
File Yes Name of the image, where the sprite exists.
Group Yes Sprite group name.
Number in Group Yes Number in group.
Row Yes Row position of sprite in the image starting from 1.
Column Yes Column position of sprite in the row of the image starting from 1
X No Start x position of the sprite starting from 0 and starting from the top-left corner. If the value is empty, then the X value is calculated automatically.
Y Yes Start y position of the sprite starting from 0 and starting from the top-left corner. The value cannot be empty.
Width Yes Width of the sprite.
Height Yes for 1st column Height of the sprite. If the number of column is larger than 1 and the height is greater, than the height of the previous column, than the height is interpreted as an addition to the height of the previous sprite.
Notes No Notes
Tags No Tags
Number per file Yes Number of sprite in the image file


Example

File Group Number in Group Row Column X Y Width Height Notes Tags Number per file
blupi000.blp Yellow_Eggbert_Born 1 1 1 0 28 20 ok 1
blupi000.blp Yellow_Eggbert_Born 2 1 2 0 28 0 ok 2
blupi000.blp Yellow_Eggbert_Born 3 1 3 0 28 3 ok 3
blupi000.blp Yellow_Eggbert_Born 4 1 4 0 28 0 ok 4
blupi000.blp Yellow Bomb 1 1 5 0 34 1 ok 5
blupi000.blp Yellow Bomb 2 1 6 0 38 0 ok 6
blupi000.blp Yellow Bomb 3 1 7 0 40 0 ok 7
blupi000.blp Yellow Bomb 4 1 8 0 42 0 ok 8
blupi000.blp Yellow Bomb 5 1 9 0 44 0 ok 9
blupi000.blp Yellow Bomb 6 1 10 0 45 0 ok 10
blupi000.blp Yellow_Eggbert_Life 1 1 11 0 17 1 ok 11
blupi000.blp Yellow_Eggbert_Born 5 1 12 0 28 2 ok 12
blupi000.blp Yellow_Eggbert_Born 6 1 13 0 28 2 ok 13
blupi000.blp Yellow_Eggbert_Born 7 1 14 0 28 1 ok 14
blupi000.blp Yellow_Eggbert_Born 8 1 15 0 28 1 ok 15
blupi000.blp Yellow_Eggbert_Swimming_Right 1 1 16 0 53 0 ok 16
blupi000.blp Yellow_Eggbert_Swimming_Left 1 1 17 0 60 0 ok 17
blupi000.blp Yellow_Eggbert_Born 9 1 18 0 28 1 ok 18
blupi000.blp Yellow_Eggbert_Swimming_Left 2 1 19 0 46 0 ok 19
blupi000.blp Yellow_Eggbert_Swimming_Left 3 1 20 0 46 0 ok 20
blupi000.blp Yellow_Eggbert_Swimming_Right 2 1 21 0 47 0 ok 21
blupi000.blp Yellow_Eggbert_Swimming_Right 3 2 1 32 47 32 ok 22
blupi000.blp Yellow_Eggbert_Swimming_Left 4 2 2 32 47 0 ok 23
blupi000.blp Yellow_Eggbert_Swimming_Right 4 2 3 32 48 0 ok 24
blupi000.blp Yellow_Eggbert_Swimming_Right 5 2 4 32 48 0 ok 25
blupi000.blp Yellow_Eggbert_Swimming_Left 5 2 5 32 48 0 ok 26
blupi000.blp Yellow_Eggbert_Swimming_Left 6 2 6 32 48 0 ok 27
blupi000.blp Yellow_Eggbert_Swimming_Right 6 2 7 32 49 0 ok 28
blupi000.blp Yellow_Eggbert_Swimming_Right 7 2 8 32 49 0 ok 29
blupi000.blp Yellow_Eggbert_Swimming_Left 7 2 9 32 49 0 ok 30
blupi000.blp Yellow_Eggbert_Swimming_Right 8 2 10 32 49 0 ok 31
blupi000.blp Yellow_Eggbert_Swimming_Butt 1 2 11 32 52 0 ok 32
blupi000.blp Yellow_Eggbert_Swimming_Left 8 2 12 32 54 0 ok 33
blupi000.blp Yellow_Eggbert_Swimming_Right 9 2 13 32 57 0 ok 34
blupi000.blp Yellow_Eggbert_Swimming_Left 9 2 14 32 58 0 ok 35
blupi000.blp Yellow_Eggbert_Crouching_Left 1 2 15 32 37 7 ok 36
blupi000.blp Yellow_Eggbert_Crouching_Right 1 2 16 32 37 0 ok 37
Retrieved from "https://openeggbert.com/index.php?title=Sprite_Utils&oldid=1270"