RESCUE FOR 4D DOCUMENTATION - Editor

• Editor
• Order the Resources
• Hexadecimal Editor
  • Edit a resource
  • Mark Buttom
  • Jump Buttom
  • Information about the selection
  • Cursor Moving
• Save a Resource
• Open a Resource
• Print a Resource
• Delete a Resource
• Search a Resource

Editor allows you to edit the internal resources of a 4th Dimension™ structure file.

 

Editor allows you to open Not Compiled structures (Version 5 and 4D First ) on Mac and PC.

 

When you open a 4D ressources , a window appears which will allow you to view the 4D ressources according to which choice you made in preferences.

 

 

The editor displays the list of resource types for the structure file.

 

The selection of a type appears :

 

• The list of resources includes :
  • The resource number (ID),
  • The resource size (Size),
  • and a comments column (comments) if the Editor preferences setting allows it. A resource of type CC4D, which appears without information, indicates that it is a script, a layout formula, or a file formula.

   

• The explanation of the type which is displayed above the progress bar, is that this is a type known by Rescue for 4D,

 

• and in the Current Type zone :
  • the resources Number, Nbr Resources,
  • The total size,Total Size, they occupy ( in bytes) in the database.

 

---

Order the resources :

 

You can order resources according to :

• their number, ID,
• their size, size,
• or their comment, comments

either ascending (Click) or descending (Option-Click), by clicking on the title of the respective column.
(ID, Size, or Comment)

An underlined title means the resources are ordered by that title.

 

---

Hexadecimal Editor

 

Edit a resource :

 

Double click on a resource to edit :

 

The resource TP4D contains the names of the procedures and their relation to CC4D.

In this example, the offset 0 contains 0D, which is to say the size of the procedure name (13 characters) ;
And the following 13 bytes contain the procedure name itself : AE_FindObject.
Since the name of the procedure cannot exceed 15 characters, 2 bytes remain unused.
The offset 10 contains the ID of the resource CC4D, which is 3C61 in hexadecimal (15457 in decimal, 6th line of CC4D).

 

The Mark button:

It allows you to record the current position of the cursor and the selection.

• To pose a mark, click on Mark while holding the Option key.
• To make a steady mark, click on Mark.

 

The Jump button :

It automatically moves when four bytes are selected and when their contents contain a corresponding valid address in the resource editor :

• Option-Click and the software records the current position, after which, by clicking on the Mark button you will jump directly to the address selected.
• Click the button and jump to the address selected.
• Command-Click on the button and jump in relative mode (selected address + selected value).

 

Information about the selection :

• Information about the cursor position and the selection size is displayed at the bottom of the window. This information is in Decimal and Hexadecimal format.
• The type is automatically displayed on the right-hand side of the bottom of the window, the value of the selection is in Decimal format. The selection must not exceed 4 characters.
• If a byte is selected, it is displayed in the form of a Bit (at the bottom of the window, on the right, in square brackets) in addition to its Decimal value.

 

Moving of cursor on the selection :

• The Active cursor and the selection can go from the Hexa zone <-> Decimal with the tab key.
• You can use the Shift key to extend the selection.

 

---

Save a resource :

 

You can record a resource from :

• Editor : select a type and a resource then File Menu Save Resource.
  (Ex: Type 'WN4D' - ID 0.Res) a dash separates the type from the ID.
• Editor Hexa editing :
  • The whole resource : do File-Save
    (Ex: Type 'WN4D' ~ ID 0.Res) a tilde separates the type from the ID)
  • A section of the resource : do File-Save Selection.
    (Ex: Type 'WN4D' ~ ID 0.Res) a tilde separates the type from the ID )

 

---

Open a resource :

 

You can open a previously stored resource .

In this case, the name of the new window is preceded by a pound (#) sign.

 

---

Print a resource :

 

You can print the types list, the resource list, and a resource content by doing
File- Print.

 

 

The types list of the database can be found in the left-hand column.

 

You must select the types you want to print.

 

The All button allows you to select or unselect (with the Option key) all the resources.

The pop-up Sort allows you to define the sort order for printing.

The Comments Zone allows you to define the content of the column comment when you print. It functions the same as the pop-up in Preferences.

---

Delete a resource :

 

To delete a resource in Editor, select it and click on the "trash" icon. The "trash" icon is located to the right of the progress bar.

Depending upon the resource type selected, you may get a warning :

• Resource is not essential to the functioning of 4D.

 

Click on the OK button to confirm the deletion
or the Cancel button to cancel.

 

• Resource is essential to the functioning of 4D.

 

You cannot delete this resource.

 

 

---

Search :

 

Searching by type and by resource (ASCII & Hexadecimal mode) is possible in the Search menu.

 

 

 

• Open All option

The Open All check box is only active if you perform a search on the types. If you select this option, Rescue for 4D opens all resources which contain the search string, each with its own window.

 

• Wrap option

  If this option is selected, you may restart a search, from the beginning, if the last search arrives at the end of the resource.

  This option is not active when the Open All option is selected.

   

• Hexa option

If selected, this option will search in Hexadecimal mode ; the default (unselected) search is in ASCII mode.