Keen:Planet Modding/Compass: Difference between revisions
Jump to navigation
Jump to search
Texture:
In-game look:
*note that background crop and bottom crop are not used in vanilla (empty opaque texture)
CptTwinkie (talk | contribs) |
CptTwinkie (talk | contribs) mNo edit summary |
||
| (13 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
==Compass modding | <noinclude>{{SEO|image_url=http://www.medievalengineerswiki.com/images/f/f8/In-gameCompassZones.png|description=Just like with map sprites, we save main compass elements on a single texture, then define parts of it using pixel coordinates.}} | ||
{{Keen:OCH}} | |||
{{Version <!-- Do not change the version until the entire page is up-to-date --> | |||
|release=0|major=4|minor=X|suppress=true}} | |||
[[Category:Keen Modding Guides]]</noinclude> | |||
==[[Keen:Planet Modding/Compass|Compass modding]]== | |||
It is possible to mod visual look of an in-game compass. All definitions of compass are stored in Content\Data\GUI\CompassDefinition.sbc. Our textures for compass are in Content\Textures\GUI\Compass folder if you want to check out how they look or use them in your mod. | It is possible to mod visual look of an in-game compass. All definitions of compass are stored in Content\Data\GUI\CompassDefinition.sbc. Our textures for compass are in Content\Textures\GUI\Compass folder if you want to check out how they look or use them in your mod. | ||
===Creating compass texture atlas and setting coordinates for its elements=== | ===Creating compass texture atlas and setting coordinates for its elements=== | ||
Just like with map sprites, we save main compass elements on a single texture, then define parts of it using pixel coordinates. First setup origin point, then add width and height of the rectangle | Just like with map sprites, we save main compass elements on a single texture, then define parts of it using pixel coordinates. First setup origin point, then add width and height of the rectangle | ||
Example texture coordinates for top part of the compass: | Example texture coordinates for top part of the compass: | ||
[[File:CompassTextureCoordinates.png|1024px|center]] | [[File:CompassTextureCoordinates.png|1024px|center]] | ||
< | <syntaxhighlight lang="xml"><TopCrop X="0" Y="0" Width="512" Height="32"/></syntaxhighlight> | ||
==Explanation of compass | ===Explanation of compass definition line by line=== | ||
< | <syntaxhighlight lang="xml" line> | ||
Path to a texture atlas. | <Texture>Textures/GUI/Compass/compass.png</Texture><!-- Path to a texture atlas. --> | ||
<KingdomIcon>Textures/GUI/Compass/Icon-Kingdom.png</KingdomIcon><!-- Path to icon symbolizing a kingdom. --> | |||
Path to icon symbolizing a kingdom. | <Padding>7</Padding><!-- Padding is added vertically between the top and bottom textures and the edges of the contents of the compass. --> | ||
<TopCrop X="0" Y="0" Width="512" Height="32"/><!-- Rectangle in the texture that contains the top part. --> | |||
Padding is added vertically between the top and bottom textures and the edges of the contents of the compass. | <BottomCrop X="0" Y="0" Width="0" Height="0"/><!-- Rectangle in the texture that contains the bottom part. --> | ||
<BackgroundCrop X="0" Y="64" Width="512" Height="64"/><!-- Rectangle in the texture that contains the background. --> | |||
Rectangle in the texture that contains the top part. | <ArrowCrop X="0" Y="128" Width="32" Height="32"/><!-- Rectangle in the texture that contains the little marker used for elements that are drawn and have no icon. --> | ||
<MarkerCrop X="32" Y="128" Width="32" Height="32"/><!-- Rectangle in the texture that contains the interval bars drawn every few degrees. --> | |||
Rectangle in the texture that contains the bottom part. | <ShadowCrop X="64" Y="128" Width="80" Height="32" Left="8" Right="8"/> | ||
<ShadowPadding Left="12" Top="8" Right="12" Bottom="8"/><!-- Rectangle in the texture that contains the text shadows. Shadow is 3-Sliced, meaning the texture is split in three parts: [left|middle|right] | |||
Rectangle in the texture that contains the background. | The sizes of left and right define the cropping lines that split the texture into three. The Sides are then always kep proportional as the texture is scaled. --> | ||
<VisibleRange>200</VisibleRange><!-- Visible range in degrees. --> | |||
Rectangle in the texture that contains the little marker used for elements that are drawn and have no icon. | <Width>700</Width><!-- Width in reference resolution pixels. --> | ||
<FontSize>1.1</FontSize><!-- Scale of the font based on default. --> | |||
Rectangle in the texture that contains the interval bars drawn every few degrees. | <VerticalOffset>0.065</VerticalOffset><!-- Vertical offset from the top of the screen. 0 = top of the screen, 1 is the bottom. Compass is centered around this position. --> | ||
<TagStyles><!-- This section adds tags that are visible on compass and in which style. Currently we have 3 types of tags. Claim area - shows your claimed area on the compass, Kingdom tag shows kingdoms and Cardinal tag shows cardinal points (North, South,...). Each tag’s visual appearance is defined in tag/waypoint definition. Styles defines where should the text appear. Available styles: Center, IconOnly, NotShown, Bellow, Above. --> | |||
Rectangle in the texture that contains the text shadows. Shadow is 3-Sliced, meaning the texture is split in three parts: [left|middle|right] | |||
The sizes of left and right define the cropping lines that split the texture into three. The Sides are then always kep proportional as the texture is scaled. | |||
Visible range in degrees. | |||
Width in reference resolution pixels. | |||
Scale of the font based on default. | |||
Vertical offset from the top of the screen. 0 = top of the screen, 1 is the bottom. Compass is centered around this position. | |||
< | |||
<TagStyle Tag="ClaimArea" Style="Bellow" MaxCharacters="15" Ellipsis="true"/> | <TagStyle Tag="ClaimArea" Style="Bellow" MaxCharacters="15" Ellipsis="true"/> | ||
<TagStyle Tag="Cardinal" Style="Above" MaxCharacters="1"/> | <TagStyle Tag="Cardinal" Style="Above" MaxCharacters="1"/> | ||
<TagStyle Tag="Kingdom" Style="Bellow"/> | <TagStyle Tag="Kingdom" Style="Bellow"/> | ||
</TagStyles> | </TagStyles> | ||
</ | </syntaxhighlight> | ||
==Explanation of Waypoint/Tag definition== | ===Explanation of Waypoint/Tag definition=== | ||
< | <syntaxhighlight lang="xml" line> | ||
<Definition xsi:type="MyObjectBuilder_WaypointDefinition"> | <Definition xsi:type="MyObjectBuilder_WaypointDefinition"> | ||
<Id Type="MyObjectBuilder_WaypointDefinition" Subtype="Kingdom"/> | <Id Type="MyObjectBuilder_WaypointDefinition" Subtype="Kingdom"/> | ||
| Line 52: | Line 49: | ||
<Color R="255" G="255" B="255" A="255"/> | <Color R="255" G="255" B="255" A="255"/> | ||
</Definition> | </Definition> | ||
</ | </syntaxhighlight> | ||
IconPath contains path to the texture of kingdom icon. Color defines color of the text that is shown with the icon. (Example: Fareon, [[File:Kingdom Icon.png| | IconPath contains path to the texture of kingdom icon. Color defines color of the text that is shown with the icon. (Example: Fareon, [[File:Kingdom Icon.png|frameless]]) | ||
===Compass texture vs in-game look comparison=== | ===Compass texture vs in-game look comparison=== | ||
Texture: | <center>Texture:</center> | ||
[[File:Compas Texture with Zones.png|1024px|center]] | |||
<center>In-game look:</center> | |||
[[File: | [[File:In-gameCompassZones.png|1024px|center]] | ||
<center><NoWiki>*</NoWiki>note that background crop and bottom crop are not used in vanilla (empty opaque texture)</center> | |||
[[ | <noinclude>View the full [[Keen:Planet Modding - Full Guide|Planet Modding Guide]]</noinclude> | ||
Latest revision as of 20:23, 18 July 2022
 OFFICIAL CONTENT NOTICE
|
|---|
 OFFICIAL CONTENT |
| Version: | 0.4 |
Compass modding
It is possible to mod visual look of an in-game compass. All definitions of compass are stored in Content\Data\GUI\CompassDefinition.sbc. Our textures for compass are in Content\Textures\GUI\Compass folder if you want to check out how they look or use them in your mod.
Creating compass texture atlas and setting coordinates for its elements
Just like with map sprites, we save main compass elements on a single texture, then define parts of it using pixel coordinates. First setup origin point, then add width and height of the rectangle Example texture coordinates for top part of the compass:
<TopCrop X="0" Y="0" Width="512" Height="32"/>
Explanation of compass definition line by line
<Texture>Textures/GUI/Compass/compass.png</Texture><!-- Path to a texture atlas. -->
<KingdomIcon>Textures/GUI/Compass/Icon-Kingdom.png</KingdomIcon><!-- Path to icon symbolizing a kingdom. -->
<Padding>7</Padding><!-- Padding is added vertically between the top and bottom textures and the edges of the contents of the compass. -->
<TopCrop X="0" Y="0" Width="512" Height="32"/><!-- Rectangle in the texture that contains the top part. -->
<BottomCrop X="0" Y="0" Width="0" Height="0"/><!-- Rectangle in the texture that contains the bottom part. -->
<BackgroundCrop X="0" Y="64" Width="512" Height="64"/><!-- Rectangle in the texture that contains the background. -->
<ArrowCrop X="0" Y="128" Width="32" Height="32"/><!-- Rectangle in the texture that contains the little marker used for elements that are drawn and have no icon. -->
<MarkerCrop X="32" Y="128" Width="32" Height="32"/><!-- Rectangle in the texture that contains the interval bars drawn every few degrees. -->
<ShadowCrop X="64" Y="128" Width="80" Height="32" Left="8" Right="8"/>
<ShadowPadding Left="12" Top="8" Right="12" Bottom="8"/><!-- Rectangle in the texture that contains the text shadows. Shadow is 3-Sliced, meaning the texture is split in three parts: [left|middle|right]
The sizes of left and right define the cropping lines that split the texture into three. The Sides are then always kep proportional as the texture is scaled. -->
<VisibleRange>200</VisibleRange><!-- Visible range in degrees. -->
<Width>700</Width><!-- Width in reference resolution pixels. -->
<FontSize>1.1</FontSize><!-- Scale of the font based on default. -->
<VerticalOffset>0.065</VerticalOffset><!-- Vertical offset from the top of the screen. 0 = top of the screen, 1 is the bottom. Compass is centered around this position. -->
<TagStyles><!-- This section adds tags that are visible on compass and in which style. Currently we have 3 types of tags. Claim area - shows your claimed area on the compass, Kingdom tag shows kingdoms and Cardinal tag shows cardinal points (North, South,...). Each tag’s visual appearance is defined in tag/waypoint definition. Styles defines where should the text appear. Available styles: Center, IconOnly, NotShown, Bellow, Above. -->
<TagStyle Tag="ClaimArea" Style="Bellow" MaxCharacters="15" Ellipsis="true"/>
<TagStyle Tag="Cardinal" Style="Above" MaxCharacters="1"/>
<TagStyle Tag="Kingdom" Style="Bellow"/>
</TagStyles>
Explanation of Waypoint/Tag definition
<Definition xsi:type="MyObjectBuilder_WaypointDefinition">
<Id Type="MyObjectBuilder_WaypointDefinition" Subtype="Kingdom"/>
<IconPath>Textures/GUI/Compass/IconKeep.png</IconPath>
<Color R="255" G="255" B="255" A="255"/>
</Definition>
IconPath contains path to the texture of kingdom icon. Color defines color of the text that is shown with the icon. (Example: Fareon, 
)
Compass texture vs in-game look comparison
View the full Planet Modding Guide