Layout Resources

From IPodWizard.net Wiki

Contents

Getting Started with Resources

The Layouts/Resources tab of iPodWizard is a highly useful and highly risky tool to use in iPod modding. Unlike most themes, which just change images, editing resources change the functionality and format of the iPod. Many great hacks, such as the iPod classic hack, the background hack, and so forth, depend on editing resource values to change how the iPod behaves. However, if you change the wrong value, you can potentially cause problems for your iPod. These range in severity from incorrect formatting to reboot loops, and in the worst case they can brick your iPod and make it unrecoverable. The latter happens very rarely, but it is possible.

There are four main types of resources:

Scheme layouts- These resources determine which images, strings, fonts, and menus are displayed where and when.

Menus- The contents of all menus on the iPod and how they react. These can be modified to change the function of certain menus.

Font Types- How characters are displayed. These control font color, text size, text style, alignment, etc.

Command Tables- At the moment, it is not completely configured but decides the basic reactions of actions.

General Resource Editing

To edit a resource:

1. Click on the Layouts/Resources tab of iPW.

2. Choose the type of resource that you wish to edit from the drop down menu.

3. Navigate to the resource of interest. You may either scroll through the list and click on the resource, or you can search for it in the top text box by typing in the number and clicking 'Find' or 'Find next'.

4. Click on the value you wish to edit (Block size, z0, ID, unk1, z1, z2, etc).

5. Type in the new value in the second long text box. Or, you may edit it directly in the hex editor.

6. Click "Change value".

7. iPW will tell you that the value was successfully changed. If your input was invalid, iPW will notify you of the error and not change anything.


The Values and their Functions

ID: This determines what the resource is and what it refers to.

Type: determines the type of resource, such as an image, another resource, a string, a command, etc.

  • paMB: image
  • warD: image that can move and change.
  • rtS: string
  • lntC: command/control
  • enoN: resource
  • stsT: collection of strings
  • mTtD: currently unknown

Notice how the words are reversed (paMB -> BMap, rtS -> Str, etc)

top- Refers to how far from the top of the screen that a resource is placed

left- Refers to how far from the right side of the screen a resource is placed

bottom/right- How much room a resource is allowed to take up in that direction.

Note: All distance is in pixels.

z values: The function of these values varies according to the type of resource that is concerned. Currently only a few of these functions are known.

  • z0 - Corresponds to the type of resource.
    • 4376 - paMB image. Will make the image visible.
    • 20992 - paMB image. Will hide the image.
    • 5504 - rtS resource. Used by virtually all rtS resources.
    • 7936 - enoN resource. Indicates a scroll bar.
    • enoN resources vary greatly in their z0 values, so do not consider this an exhaustive list.
  • z1 - Corresponds to the type of resource.
    • -1 - enoN resource.
    • 8 - paMB resource.
    • 11008 - rtS resource. This is one of the most commonly found, but not the only, z1 value associated with rtS resources.
  • z2 - Function is currently unknown.
  • z3 - Function varies greatly. There is no clear definition on what this controls.
  • z4 - Like z3, the function varies greatly.
  • z5 - Color of the bottom half of the selector bar.
  • z6 - Color of the top half of the selector bar.
  • z7 - Indicates the font types resource. Used only by rtS resources. This value is currently displayed in hex.

Layering:

This tricky concept is controlled by z0 and z4 values.

The titlebar text: While the top and left values control the positioning of the titlebar image, the bottom and right values control the positioning of the titlebar text. It is based on an (x, y) coordinate system. The top right hand corner is the origin. Therefore:

bottom: how far from the top the text is

right: how far from the left the text is

Much of this information came from bounci.rabbit.123's website and all information is credited to the users listed there.

For additional information: | iPW Resources Documentation

On The Fly Images and Strings Worth Mentioning

773, 775 and maybe 772(on the fly)=in some cases the arrow icon


NOTES: The Bytes are reversed, so 12 34 56 78 would actually translate into 78 56 34 12, so keep that in mind

SourceForge Logo