| Offset 1, 9 lines modified | Offset 1, 9 lines modified |
| 1 | <FILENAME·filename="index.html"><html><head><title>The·Okteta·Handbook</title><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-default.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-docs.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-localised.css"><meta·name="generator"·content="DocBook·XSL·Stylesheets·V1.76.1"><meta·name="description"·content="Okteta·is·a·simple·editor·for·the·raw·data·of·files.·This·type·of·program·is·also·called·hex·editor·or·binary·editor."><meta·name="keywords"·content="KDE,·kdesdk,·Okteta,·view,·edit,·bits,·bytes,·binary,·octal,·hexadecimal,·hex·editor,·raw·data"><link·rel="home"·href="index.html"·title="The·Okteta·Handbook"><link·rel="next"·href="introduction.html"·title="Chapter 1. Introduction"><meta·http-equiv="Content-Type"·content="text/html;·charset=utf-8"><meta·name="GENERATOR"·content="KDE·XSL·Stylesheet·V1.14·using·libxslt"></head><body·bgcolor="white"·text="black"·link="#0000FF"·vlink="#840084"·alink="#0000FF"><div·id="con·✂ | 1 | <FILENAME·filename="index.html"><html><head><title>The·Okteta·Handbook</title><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-default.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-docs.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-localised.css"><meta·name="generator"·content="DocBook·XSL·Stylesheets·V1.76.1"><meta·name="description"·content="Okteta·is·a·simple·editor·for·the·raw·data·of·files.·This·type·of·program·is·also·called·hex·editor·or·binary·editor."><meta·name="keywords"·content="KDE,·kdesdk,·Okteta,·view,·edit,·bits,·bytes,·binary,·octal,·hexadecimal,·hex·editor,·raw·data"><link·rel="home"·href="index.html"·title="The·Okteta·Handbook"><link·rel="next"·href="introduction.html"·title="Chapter 1. Introduction"><meta·http-equiv="Content-Type"·content="text/html;·charset=utf-8"><meta·name="GENERATOR"·content="KDE·XSL·Stylesheet·V1.14·using·libxslt"></head><body·bgcolor="white"·text="black"·link="#0000FF"·vlink="#840084"·alink="#0000FF"><div·id="con·✂ |
| 2 | ··is·also·called·hex·editor·or·binary·editor.</p></div></div></div></div><hr></div><div·class="toc"><p><b>Table·of·Contents</b></p><dl><dt><span·class="chapter"><a·href="introduction.html">1.·Introduction</a></span></dt><dt><span·class="chapter"><a·href="basics.html">2.·Basics</a></span></dt><dd><dl><dt><span·class="sect1"><a·href="basics.html#starting-basics">Starting·<span·class="application">Okteta</span></a></span></dt><dt><span·class="sect1"><a·href="usage-basics.html">Usage</a></span></dt></dl></dd><dt><span·class="chapter"><a·href="tools.html">3.·Tools</a></span></dt><dd><dl><dt><span·class="sect1"><a·href="tools.html#tools-overview">Overview</a></span></dt><dd><dl><dt><span·class="sect2"><a·href="tools.html#idp148745400">Analyzers·and·Manipulators</a></span></dt><dt><span·class="sect2"><a·href="tools.html#idp148758456">General·tools</a></span></dt></dl></dd><dt><span·class="sect1"><a·href="tools-structures.html">Structures·Tool</a></span></dt><dd><dl><dt><span·class="sect2"><a·href="tools-structures.h·✂ | 2 | ··is·also·called·hex·editor·or·binary·editor.</p></div></div></div></div><hr></div><div·class="toc"><p><b>Table·of·Contents</b></p><dl><dt><span·class="chapter"><a·href="introduction.html">1.·Introduction</a></span></dt><dt><span·class="chapter"><a·href="basics.html">2.·Basics</a></span></dt><dd><dl><dt><span·class="sect1"><a·href="basics.html#starting-basics">Starting·<span·class="application">Okteta</span></a></span></dt><dt><span·class="sect1"><a·href="usage-basics.html">Usage</a></span></dt></dl></dd><dt><span·class="chapter"><a·href="tools.html">3.·Tools</a></span></dt><dd><dl><dt><span·class="sect1"><a·href="tools.html#tools-overview">Overview</a></span></dt><dd><dl><dt><span·class="sect2"><a·href="tools.html#idp148737208">Analyzers·and·Manipulators</a></span></dt><dt><span·class="sect2"><a·href="tools.html#idp148750264">General·tools</a></span></dt></dl></dd><dt><span·class="sect1"><a·href="tools-structures.html">Structures·Tool</a></span></dt><dd><dl><dt><span·class="sect2"><a·href="tools-structures.h·✂ |
| 3 | and·as·the·character·assigned·to·the·values.·Values·and·characters·can·be·shown | 3 | and·as·the·character·assigned·to·the·values.·Values·and·characters·can·be·shown |
| 4 | either·in·two·columns·(the·traditional·display·in·hex·editors)·or·in·rows·with | 4 | either·in·two·columns·(the·traditional·display·in·hex·editors)·or·in·rows·with |
| 5 | the·value·on·top·of·the·character.·Editing·can·be·done·both·for·the·values·and | 5 | the·value·on·top·of·the·character.·Editing·can·be·done·both·for·the·values·and |
| 6 | for·the·characters.</p><p>Besides·the·usual·editing·capabilities·<span·class="application">Okteta</span>·also·brings·a·small·set·of | 6 | for·the·characters.</p><p>Besides·the·usual·editing·capabilities·<span·class="application">Okteta</span>·also·brings·a·small·set·of |
| 7 | tools,·like·a·table·listing·decodings·into·common·simple·data·types,·a·table | 7 | tools,·like·a·table·listing·decodings·into·common·simple·data·types,·a·table |
| 8 | listing·all·possible·bytes·with·its'·character·and·value·equivalents,·an·info | 8 | listing·all·possible·bytes·with·its'·character·and·value·equivalents,·an·info |
| 9 | view·with·a·statistic,·a·checksum·calculator,·a·filter·tool·and·a·string | 9 | view·with·a·statistic,·a·checksum·calculator,·a·filter·tool·and·a·string |
| Offset 37, 15 lines modified | Offset 37, 15 lines modified |
| 37 | ····be·active.</p></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="basics.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="tools.html">Next</a></td></tr><tr><td·class="prevCell">Basics </td><td·class="upCell">Basics</td><td·class="nextCell"> Tools</td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="introduction.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="usage-basics.html">Next</a></td></tr><tr><td·class="prevCell">Introduction </td·✂ | 37 | ····be·active.</p></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="basics.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="tools.html">Next</a></td></tr><tr><td·class="prevCell">Basics </td><td·class="upCell">Basics</td><td·class="nextCell"> Tools</td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="introduction.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="usage-basics.html">Next</a></td></tr><tr><td·class="prevCell">Introduction </td·✂ |
| 38 | ··and·some·with·more·general·purpose.·These·tools·can·be·activated·or·deactivated·from | 38 | ··and·some·with·more·general·purpose.·These·tools·can·be·activated·or·deactivated·from |
| 39 | ··the·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenu">Tools</span></span>·entry·in·the·menu·bar.·Each·tool·has·a·small·view, | 39 | ··the·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenu">Tools</span></span>·entry·in·the·menu·bar.·Each·tool·has·a·small·view, |
| 40 | ··which·docks·either·in·one·of·the·sidebars·or·freely·floats·as·a·window.·You | 40 | ··which·docks·either·in·one·of·the·sidebars·or·freely·floats·as·a·window.·You |
| 41 | ··can·dock,·undock,·rearrange·and·also·stack·the·tool·views·with·the·mouse,·by | 41 | ··can·dock,·undock,·rearrange·and·also·stack·the·tool·views·with·the·mouse,·by |
| 42 | ··pressing·the·<span·class="mousebutton">left</span>·mouse·button·on·the·title·bar·of·a·tool·view,·moving·it·as·you·like·and | 42 | ··pressing·the·<span·class="mousebutton">left</span>·mouse·button·on·the·title·bar·of·a·tool·view,·moving·it·as·you·like·and |
| 43 | ··releasing·the·<span·class="mousebutton">left</span>·mouse·button·to·complete·the·action,·otherwise·cancel·it·by·pressing | 43 | ··releasing·the·<span·class="mousebutton">left</span>·mouse·button·to·complete·the·action,·otherwise·cancel·it·by·pressing |
| 44 | ··the·<span·class="keycap"><strong>Esc</strong></span>·key.</p><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148745400"></a>Analyzers·and·Manipulators</h3></div></div></div><div·class="variablelist"><dl><dt><span·class="term">Value/Char·Table</span></dt><dd><p>The·table·lists·all·possible·byte·values,·both·as·character·and | 44 | ··the·<span·class="keycap"><strong>Esc</strong></span>·key.</p><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148737208"></a>Analyzers·and·Manipulators</h3></div></div></div><div·class="variablelist"><dl><dt><span·class="term">Value/Char·Table</span></dt><dd><p>The·table·lists·all·possible·byte·values,·both·as·character·and |
| 45 | ····in·the·different·numerical·codings.</p><p>The·selected·value·can·be·inserted·at·the·cursor·position·for·a | 45 | ····in·the·different·numerical·codings.</p><p>The·selected·value·can·be·inserted·at·the·cursor·position·for·a |
| 46 | ····defined·number·of·bytes.·This·can·be·achieved·by·using·the·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guibutton">Insert</span></span> | 46 | ····defined·number·of·bytes.·This·can·be·achieved·by·using·the·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guibutton">Insert</span></span> |
| 47 | ····button·or·double-clicking·the·line·in·the·table.</p></dd><dt><span·class="term">Binary·Filter</span></dt><dd><p>The·filter·performs·binary·operations·on·the·selected·bytes. | 47 | ····button·or·double-clicking·the·line·in·the·table.</p></dd><dt><span·class="term">Binary·Filter</span></dt><dd><p>The·filter·performs·binary·operations·on·the·selected·bytes. |
| 48 | ····After·choosing·the·operation·(AND,·OR,·ROTATE..)·the·parameters, | 48 | ····After·choosing·the·operation·(AND,·OR,·ROTATE..)·the·parameters, |
| 49 | ····if·any,·can·be·set·in·the·box·below.·The·filter·is·executed·on·the·use | 49 | ····if·any,·can·be·set·in·the·box·below.·The·filter·is·executed·on·the·use |
| 50 | ····of·the·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guibutton">Filter</span></span>·button.</p></dd><dt><span·class="term">Strings</span></dt><dd><p>This·tool·locates·the·strings·in·the·selected·bytes. | 50 | ····of·the·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guibutton">Filter</span></span>·button.</p></dd><dt><span·class="term">Strings</span></dt><dd><p>This·tool·locates·the·strings·in·the·selected·bytes. |
| 51 | ····After·choosing·the·minimum·string·length,·the·strings·are·grepped·for | 51 | ····After·choosing·the·minimum·string·length,·the·strings·are·grepped·for |
| Offset 59, 75 lines modified | Offset 59, 75 lines modified |
| 59 | ····selected·bytes.·After·choosing·the·algorithm·and·setting·the·parameter,·if | 59 | ····selected·bytes.·After·choosing·the·algorithm·and·setting·the·parameter,·if |
| 60 | ····any,·the·sum·is·computed·on·the·use·of·the·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guibutton">Calculate</span></span> | 60 | ····any,·the·sum·is·computed·on·the·use·of·the·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guibutton">Calculate</span></span> |
| 61 | ····button.</p></dd><dt><span·class="term">Decoding·Table</span></dt><dd><p>The·table·displays·the·values·of·the·byte·or·the·bytes | 61 | ····button.</p></dd><dt><span·class="term">Decoding·Table</span></dt><dd><p>The·table·displays·the·values·of·the·byte·or·the·bytes |
| 62 | ····starting·at·the·cursor·for·some·common·simple·data·types·like·Integer·or | 62 | ····starting·at·the·cursor·for·some·common·simple·data·types·like·Integer·or |
| 63 | ····Float,·but·also·UTF-8.·Double-clicking·on·a·line·in·the·table·opens·an | 63 | ····Float,·but·also·UTF-8.·Double-clicking·on·a·line·in·the·table·opens·an |
| 64 | ····editor,·so·the·value·can·be·edited·and·changed.</p></dd><dt><span·class="term">Structures</span></dt><dd><p>This·tool·enables·investigating·and·editing·of·byte·arrays | 64 | ····editor,·so·the·value·can·be·edited·and·changed.</p></dd><dt><span·class="term">Structures</span></dt><dd><p>This·tool·enables·investigating·and·editing·of·byte·arrays |
| 65 | ····based·on·user-creatable·structure·definitions.·Detailed·instructions·are·in | 65 | ····based·on·user-creatable·structure·definitions.·Detailed·instructions·are·in |
| 66 | ····an·own·<a·class="link"·href="tools-structures.html"·title="Structures·Tool">section</a>.</p></dd></dl></div></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148758456"></a>General·tools</h3></div></div></div><div·class="variablelist"><dl><dt><span·class="term">Filesystem</span></dt><dd><p>This·tool·offers·an·embedded·file·browser·which | 66 | ····an·own·<a·class="link"·href="tools-structures.html"·title="Structures·Tool">section</a>.</p></dd></dl></div></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148750264"></a>General·tools</h3></div></div></div><div·class="variablelist"><dl><dt><span·class="term">Filesystem</span></dt><dd><p>This·tool·offers·an·embedded·file·browser·which |
| 67 | ····can·be·used·to·select·files·to·open.</p></dd><dt><span·class="term">Documents</span></dt><dd><p>This·tool·shows·all·currently·created·or·loaded·files. | 67 | ····can·be·used·to·select·files·to·open.</p></dd><dt><span·class="term">Documents</span></dt><dd><p>This·tool·shows·all·currently·created·or·loaded·files. |
| 68 | ····Symbols·mark·the·file·with·the·currently·active·view·and·also·show·which | 68 | ····Symbols·mark·the·file·with·the·currently·active·view·and·also·show·which |
| 69 | ····files·have·unsaved·changes·or·which·storage·copy·has·been·modified·by | 69 | ····files·have·unsaved·changes·or·which·storage·copy·has·been·modified·by |
| 70 | ····another·program.</p></dd><dt><span·class="term">Bookmarks</span></dt><dd><p>This·tool·can·be·used·to·manage·the·bookmarks,·alternatively | 70 | ····another·program.</p></dd><dt><span·class="term">Bookmarks</span></dt><dd><p>This·tool·can·be·used·to·manage·the·bookmarks,·alternatively |
| 71 | ····to·the·<a·class="link"·href="interface-overview.html#bookmarks-menu"·title="Bookmarks·Menu"><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenu">Bookmarks</span></span></a>·menu. | 71 | ····to·the·<a·class="link"·href="interface-overview.html#bookmarks-menu"·title="Bookmarks·Menu"><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenu">Bookmarks</span></span></a>·menu. |
| 72 | ····</p><div·class="note"·style="margin-left:·0.5in;·margin-right:·0.5in;"><h3·class="title">Note</h3><p>Bookmarks·are·currently·only·transient·and·not·saved·if·you | 72 | ····</p><div·class="note"·style="margin-left:·0.5in;·margin-right:·0.5in;"><h3·class="title">Note</h3><p>Bookmarks·are·currently·only·transient·and·not·saved·if·you |
| 73 | ····close·a·byte·array·or·the·whole·program.</p></div></dd><dt><span·class="term">File·Info</span></dt><dd><p>This·tool·displays·some·information·about·the·current·file, | 73 | ····close·a·byte·array·or·the·whole·program.</p></div></dd><dt><span·class="term">File·Info</span></dt><dd><p>This·tool·displays·some·information·about·the·current·file, |
| 74 | ····including·its·type,·the·location·of·storage·and·the·size.</p></dd><dt><span·class="term">Terminal</span></dt><dd><p>An·embedded·Terminal,·the·working·directory·is·not·coupled·with·the·active·file.</p></dd><dt><span·class="term">Charset·Conversion</span></dt><dd><p>The·tool·rewrites·the·bytes·so·the·respective·chars·are·the·same·as·with·the·other·charset. | 74 | ····including·its·type,·the·location·of·storage·and·the·size.</p></dd><dt><span·class="term">Terminal</span></dt><dd><p>An·embedded·Terminal,·the·working·directory·is·not·coupled·with·the·active·file.</p></dd><dt><span·class="term">Charset·Conversion</span></dt><dd><p>The·tool·rewrites·the·bytes·so·the·respective·chars·are·the·same·as·with·the·other·charset. |
| 75 | ·····Only·8-bit·charsets·are·supported,·and·unmatched·chars·are·currently·substituted·with·a·value·hardcoded·to·0. | 75 | ·····Only·8-bit·charsets·are·supported,·and·unmatched·chars·are·currently·substituted·with·a·value·hardcoded·to·0. |
| 76 | ·····</p></dd></dl></div></div></div><FILENAME·filename="tools-structures.html"><html><head><title>Structures·Tool</title><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-default.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-docs.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-localised.css"><meta·name="generator"·content="DocBook·XSL·Stylesheets·V1.76.1"><meta·name="keywords"·content="KDE,·kdesdk,·Okteta,·view,·edit,·bits,·bytes,·binary,·octal,·hexadecimal,·hex·editor,·raw·data"><link·rel="home"·href="index.html"·title="The·Okteta·Handbook"><link·rel="up"·href="tools.html"·title="Chapter 3. Tools"><link·rel="prev"·href="tools.html"·title="Chapter 3. Tools"><link·rel="next"·href="interface-overview.html"·title="Chapter 4. Interface·Overview"><meta·http-equiv="Content-Type"·content="text/html;·charset=utf-8"><meta·name="GENERATOR"·content="KDE·XSL·Stylesheet·V1.14·using·libxslt"></head><body·bgcolor="white"·text="black"·link="#0000FF"·vlink="#840084"·alink="·✂ | 76 | ·····</p></dd></dl></div></div></div><FILENAME·filename="tools-structures.html"><html><head><title>Structures·Tool</title><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-default.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-docs.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-localised.css"><meta·name="generator"·content="DocBook·XSL·Stylesheets·V1.76.1"><meta·name="keywords"·content="KDE,·kdesdk,·Okteta,·view,·edit,·bits,·bytes,·binary,·octal,·hexadecimal,·hex·editor,·raw·data"><link·rel="home"·href="index.html"·title="The·Okteta·Handbook"><link·rel="up"·href="tools.html"·title="Chapter 3. Tools"><link·rel="prev"·href="tools.html"·title="Chapter 3. Tools"><link·rel="next"·href="interface-overview.html"·title="Chapter 4. Interface·Overview"><meta·http-equiv="Content-Type"·content="text/html;·charset=utf-8"><meta·name="GENERATOR"·content="KDE·XSL·Stylesheet·V1.14·using·libxslt"></head><body·bgcolor="white"·text="black"·link="#0000FF"·vlink="#840084"·alink="·✂ |
| 77 | ······based·on·user-creatable·structure·definitions,·which·can·be·built·from | 77 | ······based·on·user-creatable·structure·definitions,·which·can·be·built·from |
| 78 | ······arrays,·unions,·primitive·types·and·enum·values.</p><p>It·has·an·own·settings·dialog,·which·can·be·reached·by·using·the | 78 | ······arrays,·unions,·primitive·types·and·enum·values.</p><p>It·has·an·own·settings·dialog,·which·can·be·reached·by·using·the |
| 79 | ······<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guibutton">Settings</span></span>·button.·There·are·various·options·that·can·be | 79 | ······<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guibutton">Settings</span></span>·button.·There·are·various·options·that·can·be |
| 80 | ······configured,·like·the·style·(decimal,·hexadecimal·or·binary)·in·which·the | 80 | ······configured,·like·the·style·(decimal,·hexadecimal·or·binary)·in·which·the |
| 81 | ······values·are·displayed.·Moreover·it·is·possible·to·choose·which·structure | 81 | ······values·are·displayed.·Moreover·it·is·possible·to·choose·which·structure |
| 82 | ······definitions·get·loaded·and·which·structures·are·shown·in·the·view.</p><p>Structures·are·defined·in·<span·class="application">Okteta</span>·Structure·Definition·files·(based | 82 | ······definitions·get·loaded·and·which·structures·are·shown·in·the·view.</p><p>Structures·are·defined·in·<span·class="application">Okteta</span>·Structure·Definition·files·(based |
| 83 | ······on·<acronym·class="acronym">XML</acronym>,·with·the·file·extension·<code·class="literal">.osd</code>). | 83 | ······on·<acronym·class="acronym">XML</acronym>,·with·the·file·extension·<code·class="literal">.osd</code>). |
| 84 | ······Additionally·a·<code·class="literal">.desktop</code>·file·contains | 84 | ······Additionally·a·<code·class="literal">.desktop</code>·file·contains |
| 85 | ······metadata·about·that·structure·description·file,·such·as·author,·homepage | 85 | ······metadata·about·that·structure·description·file,·such·as·author,·homepage |
| 86 | ······and·license.</p><p>Currently·there·is·no·built-in·support·for·creating·or·editing | 86 | ······and·license.</p><p>Currently·there·is·no·built-in·support·for·creating·or·editing |
| 87 | ······structure·definitions,·therefore·this·must·be·done·manually·as | 87 | ······structure·definitions,·therefore·this·must·be·done·manually·as |
| 88 | ······described·in·the·next·sections.</p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148774712"></a>Installing·structure·definitions</h3></div></div></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148775352"></a>Installing·using·KNewStuff</h4></div></div></div><p>The·easiest·way·of·installing·new·structure·definitions·is·by·using·the·built-in | 88 | ······described·in·the·next·sections.</p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148766520"></a>Installing·structure·definitions</h3></div></div></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148767160"></a>Installing·using·KNewStuff</h4></div></div></div><p>The·easiest·way·of·installing·new·structure·definitions·is·by·using·the·built-in |
| 89 | ········KNewStuff·support·in·<span·class="application">Okteta</span>.·To·install·an·existing·structure·open·the·settings·dialog·of·the | 89 | ········KNewStuff·support·in·<span·class="application">Okteta</span>.·To·install·an·existing·structure·open·the·settings·dialog·of·the |
| 90 | ········Structures·tool.·There·select·the·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Structures·Management</span></span>·tab·and·press·the | 90 | ········Structures·tool.·There·select·the·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Structures·Management</span></span>·tab·and·press·the |
| 91 | ········<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guibutton">Get·New·Structures...</span></span>·button.·The·dialog·that·shows·up·now·allows·you·to | 91 | ········<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guibutton">Get·New·Structures...</span></span>·button.·The·dialog·that·shows·up·now·allows·you·to |
| 92 | ········install·and·uninstall·structures.</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148777656"></a>Installing·structure·definitions·manually</h4></div></div></div><p>The·Structures·tool·looks·for·structure·descriptions·in·the | 92 | ········install·and·uninstall·structures.</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148769464"></a>Installing·structure·definitions·manually</h4></div></div></div><p>The·Structures·tool·looks·for·structure·descriptions·in·the |
| 93 | ··········subdirectory·<code·class="filename">share/apps/okteta/structures/</code> | 93 | ··········subdirectory·<code·class="filename">share/apps/okteta/structures/</code> |
| 94 | ··········of·the·user's·directory·for·program·data·(find·that·by·executing | 94 | ··········of·the·user's·directory·for·program·data·(find·that·by·executing |
| 95 | ··········<strong·class="userinput"><code><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="command"><span·class="command"><strong>kde4-config</strong></span></span>·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="option"><code·class="option">--localprefix</code></span></code></strong>). | 95 | ··········<strong·class="userinput"><code><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="command"><span·class="command"><strong>kde4-config</strong></span></span>·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="option"><code·class="option">--localprefix</code></span></code></strong>). |
| 96 | ··········You·may·need·to·create·this·directory·if·there·are·no·structure | 96 | ··········You·may·need·to·create·this·directory·if·there·are·no·structure |
| 97 | ··········definitions·installed·yet.</p><p>Two·files·exist·for·every·structure·definition:·One·file·for·the·actual·definition·and·a | 97 | ··········definitions·installed·yet.</p><p>Two·files·exist·for·every·structure·definition:·One·file·for·the·actual·definition·and·a |
| 98 | ··········<code·class="literal">.desktop</code>·file·for·the·metadata·(author,·version,·etc.).</p><p>In·that·directory·there·is·a·subdirectory·for·each·structure | 98 | ··········<code·class="literal">.desktop</code>·file·for·the·metadata·(author,·version,·etc.).</p><p>In·that·directory·there·is·a·subdirectory·for·each·structure |
| 99 | ··········definition,·which·contains·both·the·<code·class="literal">.desktop</code> | 99 | ··········definition,·which·contains·both·the·<code·class="literal">.desktop</code> |
| 100 | ··········file·and·the·<code·class="literal">.osd</code>·or | 100 | ··········file·and·the·<code·class="literal">.osd</code>·or |
| 101 | ··········<code·class="filename">main.js</code>·file·of·that·definition.</p><p>For·example,·with·the·program·data·directory·<code·class="filename">.kde</code> | 101 | ··········<code·class="filename">main.js</code>·file·of·that·definition.</p><p>For·example,·with·the·program·data·directory·<code·class="filename">.kde</code> |
| 102 | ··········and·a·structure·definition·named·ExampleStructure·there·is·the·directory | 102 | ··········and·a·structure·definition·named·ExampleStructure·there·is·the·directory |
| 103 | ··········<code·class="filename">.kde/share/apps/okteta/structures/ExampleStructure</code>, | 103 | ··········<code·class="filename">.kde/share/apps/okteta/structures/ExampleStructure</code>, |
| 104 | ··········which·contains·a·file·<code·class="filename">ExampleStructure.desktop</code>·and·a | 104 | ··········which·contains·a·file·<code·class="filename">ExampleStructure.desktop</code>·and·a |
| 105 | ··········file·<code·class="filename">ExampleStructure.osd</code>.</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148785208"></a>Using·the·newly·installed·structures</h4></div></div></div><p>After·having·installed·a·new·structure·definition·you·need·to·restart·<span·class="application">Okteta</span> | 105 | ··········file·<code·class="filename">ExampleStructure.osd</code>.</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148777016"></a>Using·the·newly·installed·structures</h4></div></div></div><p>After·having·installed·a·new·structure·definition·you·need·to·restart·<span·class="application">Okteta</span> |
| 106 | ········before·you·can·use·it. | 106 | ········before·you·can·use·it. |
| 107 | ········Once·<span·class="application">Okteta</span>·has·started,·open·the·settings·dialog·of·the·Structures·tool.·There·select·the | 107 | ········Once·<span·class="application">Okteta</span>·has·started,·open·the·settings·dialog·of·the·Structures·tool.·There·select·the |
| 108 | ········<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Structures·Management</span></span>·tab·and·make·sure·the·relevant | 108 | ········<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Structures·Management</span></span>·tab·and·make·sure·the·relevant |
| 109 | ········structure·definition·is·checked.·Then·switch·to·the·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Structures</span></span>·tab·and | 109 | ········structure·definition·is·checked.·Then·switch·to·the·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guilabel">Structures</span></span>·tab·and |
| 110 | ········make·sure·the·desired·element·is·listed·on·the·right-hand·side.</p></div></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148788024"></a>Sharing·structure·definitions</h3></div></div></div><p>For·common·structures·you·may·not·need·to·create·a·definition·yourself, | 110 | ········make·sure·the·desired·element·is·listed·on·the·right-hand·side.</p></div></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148779832"></a>Sharing·structure·definitions</h3></div></div></div><p>For·common·structures·you·may·not·need·to·create·a·definition·yourself, |
| 111 | ······but·instead·can·reuse·an·already·existing·definition·from·places·like | 111 | ······but·instead·can·reuse·an·already·existing·definition·from·places·like |
| 112 | ······<a·class="ulink"·href="http://kde-files.org/index.php?xcontentmode=691"·target="_top">kde-files.org</a>.</p><p>You·also·may·want·to·share·a·definition·yourself.·To·do·so,·create·a | 112 | ······<a·class="ulink"·href="http://kde-files.org/index.php?xcontentmode=691"·target="_top">kde-files.org</a>.</p><p>You·also·may·want·to·share·a·definition·yourself.·To·do·so,·create·a |
| 113 | ······file·archive·(<abbr·class="abbrev">e.g.</abbr>·a·zipped·tar·archive,·<code·class="literal">.tar.gz</code>) | 113 | ······file·archive·(<abbr·class="abbrev">e.g.</abbr>·a·zipped·tar·archive,·<code·class="literal">.tar.gz</code>) |
| 114 | ······containing·just·the·subdirectory·with·the·<code·class="literal">.desktop</code> | 114 | ······containing·just·the·subdirectory·with·the·<code·class="literal">.desktop</code> |
| 115 | ······file·and·the·structure·definition·file.·Looking·at·the·example·in·the·last·section·this | 115 | ······file·and·the·structure·definition·file.·Looking·at·the·example·in·the·last·section·this |
| 116 | ······would·be·the·directory·<code·class="filename">ExampleStructure</code>·with·all·its·contents. | 116 | ······would·be·the·directory·<code·class="filename">ExampleStructure</code>·with·all·its·contents. |
| 117 | ······Using·this·format·for·sharing·the·structure·definitions·allows·installing·them·inside·<span·class="application">Okteta</span>·and | 117 | ······Using·this·format·for·sharing·the·structure·definitions·allows·installing·them·inside·<span·class="application">Okteta</span>·and |
| 118 | ······requires·no·manual·installation.</p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148792888"></a>Creating·structure·definitions</h3></div></div></div><p>There·are·two·different·ways·of·creating·structure·definitions.·The·first·is·writing·the | 118 | ······requires·no·manual·installation.</p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148796984"></a>Creating·structure·definitions</h3></div></div></div><p>There·are·two·different·ways·of·creating·structure·definitions.·The·first·is·writing·the |
| 119 | ······definition·in·<acronym·class="acronym">XML</acronym>·the·other·is·using·JavaScript.·The·JavaScript·approach·allows·you | 119 | ······definition·in·<acronym·class="acronym">XML</acronym>·the·other·is·using·JavaScript.·The·JavaScript·approach·allows·you |
| 120 | ······to·create·more·complex·structures·with·features·like·<abbr·class="abbrev">e.g.</abbr>·validating·the·structure.·Using·<acronym·class="acronym">XML</acronym>·gives·you | 120 | ······to·create·more·complex·structures·with·features·like·<abbr·class="abbrev">e.g.</abbr>·validating·the·structure.·Using·<acronym·class="acronym">XML</acronym>·gives·you |
| 121 | ······less·features·but·if·a·static·structure·is·all·you·need·this·may·be·the·easiest·approach.·If·you·need·a·dynamic | 121 | ······less·features·but·if·a·static·structure·is·all·you·need·this·may·be·the·easiest·approach.·If·you·need·a·dynamic |
| 122 | ······structure·i.e.·where·array·lengths·depend·on·other·values·in·the·structure·or·the·structure·layout·is·different·when | 122 | ······structure·i.e.·where·array·lengths·depend·on·other·values·in·the·structure·or·the·structure·layout·is·different·when |
| 123 | ······some·member·value·changes,·then·you·will·have·to·write·the·structure·definition·in·JavaScript. | 123 | ······some·member·value·changes,·then·you·will·have·to·write·the·structure·definition·in·JavaScript. |
| 124 | ······There·is·one·exception·to·that·rule:·if·you·have·an·array·where·the·length·is·supposed·to·be | 124 | ······There·is·one·exception·to·that·rule:·if·you·have·an·array·where·the·length·is·supposed·to·be |
| 125 | ······<span·class="bold"><strong>exactly</strong></span>·the·same·as·another·value·in·the·structure,·then·you·can·use·<acronym·class="acronym">XML</acronym>. | 125 | ······<span·class="bold"><strong>exactly</strong></span>·the·same·as·another·value·in·the·structure,·then·you·can·use·<acronym·class="acronym">XML</acronym>. |
| 126 | ······But·if·it·is·something·like·<span·class="emphasis"><em>length·-·1</em></span>·it·has·to·be·JavaScript.</p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148796728"></a>Structure·definition·<acronym·class="acronym">XML</acronym>·file·format</h3></div></div></div><p> | 126 | ······But·if·it·is·something·like·<span·class="emphasis"><em>length·-·1</em></span>·it·has·to·be·JavaScript.</p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148800824"></a>Structure·definition·<acronym·class="acronym">XML</acronym>·file·format</h3></div></div></div><p> |
| 127 | ······ | 127 | ······ |
| 128 | ······The·<code·class="literal">.osd</code>·<acronym·class="acronym">XML</acronym>·file·has·one·root·element:·<span·class="emphasis"><em><data></em></span>·with·no | 128 | ······The·<code·class="literal">.osd</code>·<acronym·class="acronym">XML</acronym>·file·has·one·root·element:·<span·class="emphasis"><em><data></em></span>·with·no |
| 129 | ······attributes.·Inside·this·element·there·must·be·one·of·the·following·elements:</p><div·class="variablelist"><dl><dt><span·class="term"><span·class="bold"><strong><span·class="emphasis"><em><primitive></em></span></strong></span></span></dt><dd><p>To·create·a·primitive·data·types·like·<abbr·class="abbrev">e.g.</abbr>·<span·class="emphasis"><em>int</em></span>·and | 129 | ······attributes.·Inside·this·element·there·must·be·one·of·the·following·elements:</p><div·class="variablelist"><dl><dt><span·class="term"><span·class="bold"><strong><span·class="emphasis"><em><primitive></em></span></strong></span></span></dt><dd><p>To·create·a·primitive·data·types·like·<abbr·class="abbrev">e.g.</abbr>·<span·class="emphasis"><em>int</em></span>·and |
| 130 | ··············<span·class="emphasis"><em>float</em></span>.·This·element·accepts·no·subelements·and·can·have·the·following·attributes:</p><div·class="variablelist"><dl><dt><span·class="term"><span·class="bold"><strong>type</strong></span></span></dt><dd><p>The·type·of·this·primitive·type.·It·must·be·one·of·the·following:</p><div·class="itemizedlist"><ul·class="itemizedlist"·type="disc"><li·class="listitem"><p><span·class="emphasis"><em>char</em></span>·for·a·8·bit·ASCII·character</p></li><li·class="listitem"><p><span·class="emphasis"><em>int8,·int16,·int32,·int64</em></span>·for·a·signed·integer·of·that·size</p></li><li·class="listitem"><p><span·class="emphasis"><em>uint8,·uint16,·uint32,·uint64</em></span>·for·an·unsigned·integer·of·that·size</p></li><li·class="listitem"><p><span·class="emphasis"><em>bool8,·bool16,·bool32,·bool64</em></span>·for·an·unsigned·boolean·(0·=·false,·any·other·value·=·true)·of·that·size</p></li><li·class="listitem"><p><span·class="emphasis"><em>float</em></span>·for·a·32·bit·IEEE75·✂ | 130 | ··············<span·class="emphasis"><em>float</em></span>.·This·element·accepts·no·subelements·and·can·have·the·following·attributes:</p><div·class="variablelist"><dl><dt><span·class="term"><span·class="bold"><strong>type</strong></span></span></dt><dd><p>The·type·of·this·primitive·type.·It·must·be·one·of·the·following:</p><div·class="itemizedlist"><ul·class="itemizedlist"·type="disc"><li·class="listitem"><p><span·class="emphasis"><em>char</em></span>·for·a·8·bit·ASCII·character</p></li><li·class="listitem"><p><span·class="emphasis"><em>int8,·int16,·int32,·int64</em></span>·for·a·signed·integer·of·that·size</p></li><li·class="listitem"><p><span·class="emphasis"><em>uint8,·uint16,·uint32,·uint64</em></span>·for·an·unsigned·integer·of·that·size</p></li><li·class="listitem"><p><span·class="emphasis"><em>bool8,·bool16,·bool32,·bool64</em></span>·for·an·unsigned·boolean·(0·=·false,·any·other·value·=·true)·of·that·size</p></li><li·class="listitem"><p><span·class="emphasis"><em>float</em></span>·for·a·32·bit·IEEE75·✂ |
| 131 | ··············attributes:</p><div·class="variablelist"><dl><dt><span·class="term"><span·class="bold"><strong>width</strong></span></span></dt><dd><p>The·number·of·bits·used·by·this·bitfield.·Must·be·between·1·and·64.</p></dd><dt><span·class="term"><span·class="bold"><strong>type</strong></span></span></dt><dd><p>The·type·of·this·bitfield.·It·must·be·one·of·the·following:</p><div·class="itemizedlist"><ul·class="itemizedlist"·type="disc"><li·class="listitem"><p><span·class="emphasis"><em>unsigned</em></span>·for·a·bitfield·where·the·value·will·be·interpreted·as | 131 | ··············attributes:</p><div·class="variablelist"><dl><dt><span·class="term"><span·class="bold"><strong>width</strong></span></span></dt><dd><p>The·number·of·bits·used·by·this·bitfield.·Must·be·between·1·and·64.</p></dd><dt><span·class="term"><span·class="bold"><strong>type</strong></span></span></dt><dd><p>The·type·of·this·bitfield.·It·must·be·one·of·the·following:</p><div·class="itemizedlist"><ul·class="itemizedlist"·type="disc"><li·class="listitem"><p><span·class="emphasis"><em>unsigned</em></span>·for·a·bitfield·where·the·value·will·be·interpreted·as |
| 132 | ······················an·unsigned·value·(value·range·from·0·to·2<sup>width</sup>·-·1)</p></li><li·class="listitem"><p><span·class="emphasis"><em>signed</em></span>·for·a·bitfield·where·the·value·will·be·interpreted·as·a | 132 | ······················an·unsigned·value·(value·range·from·0·to·2<sup>width</sup>·-·1)</p></li><li·class="listitem"><p><span·class="emphasis"><em>signed</em></span>·for·a·bitfield·where·the·value·will·be·interpreted·as·a |
| 133 | ······················signed·value·(value·range·from·-2<sup>width·-·1</sup>·to | 133 | ······················signed·value·(value·range·from·-2<sup>width·-·1</sup>·to |
| Offset 162, 15 lines modified | Offset 162, 15 lines modified |
| 162 | ··················<span·class="emphasis"><em>maxCharCount</em></span>.·With·encodings·like·<span·class="emphasis"><em>ASCII</em></span>·this·is·the·same·as | 162 | ··················<span·class="emphasis"><em>maxCharCount</em></span>.·With·encodings·like·<span·class="emphasis"><em>ASCII</em></span>·this·is·the·same·as |
| 163 | ··················<span·class="emphasis"><em>maxCharCount</em></span>.</p></dd><dt><span·class="term"><span·class="bold"><strong>type</strong></span></span></dt><dd><p>The·encoding·of·this·string.·Can·be·one·of·the·following:</p><div·class="itemizedlist"><ul·class="itemizedlist"·type="disc"><li·class="listitem"><p><span·class="emphasis"><em>ASCII</em></span></p></li><li·class="listitem"><p><span·class="emphasis"><em>LATIN-1</em></span></p></li><li·class="listitem"><p><span·class="emphasis"><em>UTF-8</em></span></p></li><li·class="listitem"><p><span·class="emphasis"><em>UTF-16-LE</em></span>·or·<span·class="emphasis"><em>UTF-16-BE</em></span>.·If·neither | 163 | ··················<span·class="emphasis"><em>maxCharCount</em></span>.</p></dd><dt><span·class="term"><span·class="bold"><strong>type</strong></span></span></dt><dd><p>The·encoding·of·this·string.·Can·be·one·of·the·following:</p><div·class="itemizedlist"><ul·class="itemizedlist"·type="disc"><li·class="listitem"><p><span·class="emphasis"><em>ASCII</em></span></p></li><li·class="listitem"><p><span·class="emphasis"><em>LATIN-1</em></span></p></li><li·class="listitem"><p><span·class="emphasis"><em>UTF-8</em></span></p></li><li·class="listitem"><p><span·class="emphasis"><em>UTF-16-LE</em></span>·or·<span·class="emphasis"><em>UTF-16-BE</em></span>.·If·neither |
| 164 | ······················<span·class="emphasis"><em>-LE</em></span>·or·<span·class="emphasis"><em>-BE</em></span>·suffix·is·given,·little·endian·is·assumed. | 164 | ······················<span·class="emphasis"><em>-LE</em></span>·or·<span·class="emphasis"><em>-BE</em></span>·suffix·is·given,·little·endian·is·assumed. |
| 165 | ······················</p></li><li·class="listitem"><p><span·class="emphasis"><em>UTF-32-LE</em></span>·or·<span·class="emphasis"><em>UTF-32-BE</em></span>.·If·neither | 165 | ······················</p></li><li·class="listitem"><p><span·class="emphasis"><em>UTF-32-LE</em></span>·or·<span·class="emphasis"><em>UTF-32-BE</em></span>.·If·neither |
| 166 | ······················<span·class="emphasis"><em>-LE</em></span>·or·<span·class="emphasis"><em>-BE</em></span>·suffix·is·given,·little·endian·is·assumed. | 166 | ······················<span·class="emphasis"><em>-LE</em></span>·or·<span·class="emphasis"><em>-BE</em></span>·suffix·is·given,·little·endian·is·assumed. |
| 167 | ······················</p></li></ul></div></dd></dl></div></dd></dl></div><p> | 167 | ······················</p></li></ul></div></dd></dl></div></dd></dl></div><p> |
| 168 | ······Every·element·also·accepts·an·attribute·<span·class="emphasis"><em>name</em></span>·which·is·then·visible·in·the·structures·view. | 168 | ······Every·element·also·accepts·an·attribute·<span·class="emphasis"><em>name</em></span>·which·is·then·visible·in·the·structures·view. |
| 169 | ······</p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148876216"></a>An·example·structure·definition·in·both·<acronym·class="acronym">XML</acronym>·and·JavaScript</h3></div></div></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148877240"></a>The·common·step·shared·by·both·approaches</h4></div></div></div><p> | 169 | ······</p></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="idp148872120"></a>An·example·structure·definition·in·both·<acronym·class="acronym">XML</acronym>·and·JavaScript</h3></div></div></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148873144"></a>The·common·step·shared·by·both·approaches</h4></div></div></div><p> |
| 170 | ········Our·metadata·file·looks·like·this: | 170 | ········Our·metadata·file·looks·like·this: |
| 171 | ········</p><pre·class="screen"> | 171 | ········</p><pre·class="screen"> |
| 172 | ········[Desktop·Entry] | 172 | ········[Desktop·Entry] |
| 173 | ········Encoding=UTF-8 | 173 | ········Encoding=UTF-8 |
| 174 | ········Icon=arrow-up<a·name="icon"></a><img·src="common/1.png"·alt="1"·border="0"> | 174 | ········Icon=arrow-up<a·name="icon"></a><img·src="common/1.png"·alt="1"·border="0"> |
| 175 | ········Type=Service | 175 | ········Type=Service |
| 176 | ········ServiceTypes=KPluginInfo | 176 | ········ServiceTypes=KPluginInfo |
| Offset 189, 15 lines modified | Offset 189, 15 lines modified |
| 189 | ········</pre><p> | 189 | ········</pre><p> |
| 190 | ········</p><div·class="calloutlist"><table·border="0"·summary="Callout·list"><tr><td·width="5%"·valign="top"·align="left"><p><a·href="#icon"><img·src="common/1.png"·alt="1"·border="0"></a>·</p></td><td·valign="top"·align="left"><p>The·icon·displayed·in·<span·class="application">Okteta</span>·for·this·structure·can·be·anything·found·by·executing | 190 | ········</p><div·class="calloutlist"><table·border="0"·summary="Callout·list"><tr><td·width="5%"·valign="top"·align="left"><p><a·href="#icon"><img·src="common/1.png"·alt="1"·border="0"></a>·</p></td><td·valign="top"·align="left"><p>The·icon·displayed·in·<span·class="application">Okteta</span>·for·this·structure·can·be·anything·found·by·executing |
| 191 | ··········<strong·class="userinput"><code><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="command"><span·class="command"><strong>kdialog</strong></span></span>·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="option"><code·class="option">--geticon</code></span></code></strong>·or·a·path·to·an·icon</p></td></tr></table></div><p> | 191 | ··········<strong·class="userinput"><code><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="command"><span·class="command"><strong>kdialog</strong></span></span>·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="option"><code·class="option">--geticon</code></span></code></strong>·or·a·path·to·an·icon</p></td></tr></table></div><p> |
| | |
| 192 | ··········These·fields·should·all·be·pretty·much·self-explanatory,·except·for | 192 | ··········These·fields·should·all·be·pretty·much·self-explanatory,·except·for |
| 193 | ··········<code·class="literal">X-KDE-PluginInfo-Name</code>.·The·value·of·this·field·must·match·the·name·of·the·directory·containing·the·file·as·well·as·the·name·of·the·<code·class="literal">.desktop</code>·file.·When·creating·<acronym·class="acronym">XML</acronym>·structure·definitions·the·name·of·the·<code·class="literal">.osd</code>·file·must·also·match·the·name.·</p><p>In·this·example·we·would·have·a·directory·named·<code·class="filename">simplestruct</code> | 193 | ··········<code·class="literal">X-KDE-PluginInfo-Name</code>.·The·value·of·this·field·must·match·the·name·of·the·directory·containing·the·file·as·well·as·the·name·of·the·<code·class="literal">.desktop</code>·file.·When·creating·<acronym·class="acronym">XML</acronym>·structure·definitions·the·name·of·the·<code·class="literal">.osd</code>·file·must·also·match·the·name.·</p><p>In·this·example·we·would·have·a·directory·named·<code·class="filename">simplestruct</code> |
| 194 | ········containing·the·file·<code·class="filename">simplestruct.desktop</code>.·When·defining·structures·in·<acronym·class="acronym">XML</acronym> | 194 | ········containing·the·file·<code·class="filename">simplestruct.desktop</code>.·When·defining·structures·in·<acronym·class="acronym">XML</acronym> |
| 195 | ········the·directory·would·also·contain·a·file·named·<code·class="filename">simplestruct.osd</code>.·Using·JavaScript·we·would·have·a·file·named·<code·class="filename">main.js</code>·instead.</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148885816"></a>A·simple·<acronym·class="acronym">XML</acronym>·structure·definition</h4></div></div></div><p> | 195 | ········the·directory·would·also·contain·a·file·named·<code·class="filename">simplestruct.osd</code>.·Using·JavaScript·we·would·have·a·file·named·<code·class="filename">main.js</code>·instead.</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148881720"></a>A·simple·<acronym·class="acronym">XML</acronym>·structure·definition</h4></div></div></div><p> |
| 196 | ··········To·start·we·create·a·definition·for·a·very·simple·test·structure | 196 | ··········To·start·we·create·a·definition·for·a·very·simple·test·structure |
| 197 | ··········containing·only·integral·data·types·(one·char,·one·32-bit·signed·integer,·and·a·bitfield). | 197 | ··········containing·only·integral·data·types·(one·char,·one·32-bit·signed·integer,·and·a·bitfield). |
| 198 | ··········This·would·be·expressed·in·C/C++·as: | 198 | ··········This·would·be·expressed·in·C/C++·as: |
| 199 | ··········</p><pre·class="screen"> | 199 | ··········</p><pre·class="screen"> |
| 200 | ··········struct·simple·{ | 200 | ··········struct·simple·{ |
| 201 | ············char·aChar; | 201 | ············char·aChar; |
| 202 | ············int·anInt; | 202 | ············int·anInt; |
| Offset 217, 15 lines modified | Offset 217, 15 lines modified |
| 217 | ··············<bitfield·name="padding"·type="unsigned"·width="7"/> | 217 | ··············<bitfield·name="padding"·type="unsigned"·width="7"/> |
| 218 | ············</struct> | 218 | ············</struct> |
| 219 | ··········</data> | 219 | ··········</data> |
| 220 | ··········</span></pre><p> | 220 | ··········</span></pre><p> |
| 221 | ··········which·is·fairly·similar·to·the·C/C++·definition. | 221 | ··········which·is·fairly·similar·to·the·C/C++·definition. |
| 222 | ··········</p><p>Now·create·a·directory·<code·class="filename">simplestruct</code> | 222 | ··········</p><p>Now·create·a·directory·<code·class="filename">simplestruct</code> |
| 223 | ··········inside·the·structure·installation·directory·(see·manually·installing·structure·definitions)· | 223 | ··········inside·the·structure·installation·directory·(see·manually·installing·structure·definitions)· |
| 224 | ··········and·copy·the·two·files·to·this·directory.·Now·you·can·restart·<span·class="application">Okteta</span>·and·use·the·new·structure.</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148890680"></a>The·simple·structure·in·JavaScript</h4></div></div></div><p> | 224 | ··········and·copy·the·two·files·to·this·directory.·Now·you·can·restart·<span·class="application">Okteta</span>·and·use·the·new·structure.</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148886584"></a>The·simple·structure·in·JavaScript</h4></div></div></div><p> |
| 225 | ········To·implement·the·structure·above·in·JavaScript,·create·a·file·named·<code·class="filename">main.js</code>·instead·of·<code·class="filename">simplestruct.osd</code>. | 225 | ········To·implement·the·structure·above·in·JavaScript,·create·a·file·named·<code·class="filename">main.js</code>·instead·of·<code·class="filename">simplestruct.osd</code>. |
| 226 | ········The·contents·of·that·file·should·be: | 226 | ········The·contents·of·that·file·should·be: |
| 227 | ········</p><pre·class="screen"> | 227 | ········</p><pre·class="screen"> |
| 228 | ········function·init()·{ | 228 | ········function·init()·{ |
| 229 | ··········var·structure·=·struct({ | 229 | ··········var·structure·=·struct({ |
| 230 | ············aChar·:·char(), | 230 | ············aChar·:·char(), |
| 231 | ············anInt·:·int32(), | 231 | ············anInt·:·int32(), |
| Offset 236, 15 lines modified | Offset 236, 15 lines modified |
| 236 | ········} | 236 | ········} |
| 237 | ········</pre><p> | 237 | ········</pre><p> |
| 238 | ········The·structure·displayed·by·<span·class="application">Okteta</span>·is·always·the·return·value·of·the·<code·class="literal">init</code>·function.</p><p> | 238 | ········The·structure·displayed·by·<span·class="application">Okteta</span>·is·always·the·return·value·of·the·<code·class="literal">init</code>·function.</p><p> |
| 239 | ········The·following·functions·can·be·called·to·create·a·primitive·type: | 239 | ········The·following·functions·can·be·called·to·create·a·primitive·type: |
| 240 | ········</p><div·class="itemizedlist"><ul·class="itemizedlist"·type="disc"><li·class="listitem"><p>char()</p></li><li·class="listitem"><p>int8(),·int16(),·int32()·or·int64()</p></li><li·class="listitem"><p>uint8(),·uint16(),·uint32()·or·uint64()</p></li><li·class="listitem"><p>bool8(),·bool16(),·bool32()·or·bool64()</p></li><li·class="listitem"><p>float()</p></li><li·class="listitem"><p>double()</p></li></ul></div><p> | 240 | ········</p><div·class="itemizedlist"><ul·class="itemizedlist"·type="disc"><li·class="listitem"><p>char()</p></li><li·class="listitem"><p>int8(),·int16(),·int32()·or·int64()</p></li><li·class="listitem"><p>uint8(),·uint16(),·uint32()·or·uint64()</p></li><li·class="listitem"><p>bool8(),·bool16(),·bool32()·or·bool64()</p></li><li·class="listitem"><p>float()</p></li><li·class="listitem"><p>double()</p></li></ul></div><p> |
| 241 | ········The·bitfield·function·takes·two·parameters,·the·first·being·a·string·consisting·of | 241 | ········The·bitfield·function·takes·two·parameters,·the·first·being·a·string·consisting·of |
| 242 | ········<code·class="literal">bool</code>,·<code·class="literal">signed</code>·or·<code·class="literal">unsigned</code>.·The·second·parameter·is·an·integer·which·sets·the·width·in·bits. | 242 | ········<code·class="literal">bool</code>,·<code·class="literal">signed</code>·or·<code·class="literal">unsigned</code>.·The·second·parameter·is·an·integer·which·sets·the·width·in·bits. |
| 243 | ········</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148898744"></a>More·complex·structures</h4></div></div></div><p> | 243 | ········</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148894648"></a>More·complex·structures</h4></div></div></div><p> |
| 244 | ········Next·we·create·a·definition·of·a·more·complex·structure·which·we·will | 244 | ········Next·we·create·a·definition·of·a·more·complex·structure·which·we·will |
| 245 | ········call·"complex"·and·save·in·a·file·named·<code·class="filename">complex.osd</code>. | 245 | ········call·"complex"·and·save·in·a·file·named·<code·class="filename">complex.osd</code>. |
| 246 | ········This·structure·will·contain·two·arrays·(one·with·fixed·length·and·one | 246 | ········This·structure·will·contain·two·arrays·(one·with·fixed·length·and·one |
| 247 | ········where·the·length·is·determined·at·runtime)·as·well·as·a·nested·structure | 247 | ········where·the·length·is·determined·at·runtime)·as·well·as·a·nested·structure |
| 248 | ········and·a·union. | 248 | ········and·a·union. |
| 249 | ········</p><pre·class="screen"><span·class="markup"> | 249 | ········</p><pre·class="screen"><span·class="markup"> |
| 250 | ··········<?xml·version="1.0"·encoding="UTF-8"?> | 250 | ··········<?xml·version="1.0"·encoding="UTF-8"?> |
| Offset 275, 15 lines modified | Offset 275, 15 lines modified |
| 275 | ··············char·string[size]·//not·valid·C++,·references·value·of·the·uint8·size | 275 | ··············char·string[size]·//not·valid·C++,·references·value·of·the·uint8·size |
| 276 | ············}; | 276 | ············}; |
| 277 | ··········}; | 277 | ··········}; |
| 278 | ··········</pre><p> | 278 | ··········</pre><p> |
| 279 | ··········</p><div·class="note"·style="margin-left:·0.5in;·margin-right:·0.5in;"><h3·class="title">Note</h3><p>You·can·obviously·only·have·dynamic·length·arrays | 279 | ··········</p><div·class="note"·style="margin-left:·0.5in;·margin-right:·0.5in;"><h3·class="title">Note</h3><p>You·can·obviously·only·have·dynamic·length·arrays |
| 280 | ··········reference·fields·before·the·array.</p></div><p>Next·we·create·the·<code·class="filename">complex.desktop</code>·file·just·as | 280 | ··········reference·fields·before·the·array.</p></div><p>Next·we·create·the·<code·class="filename">complex.desktop</code>·file·just·as |
| 281 | ··········in·the·example·before·(make·sure·you·set·<code·class="literal">X-KDE-PluginInfo-Name</code> | 281 | ··········in·the·example·before·(make·sure·you·set·<code·class="literal">X-KDE-PluginInfo-Name</code> |
| 282 | ··········correctly)·and·also·do·the·same·to·install·both·files.</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148902968"></a>Further·information</h4></div></div></div><p> | 282 | ··········correctly)·and·also·do·the·same·to·install·both·files.</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148898872"></a>Further·information</h4></div></div></div><p> |
| 283 | ··········A·few·example·structure·definitions·can·be·found·in·the·<a·class="ulink"·href="https://projects.kde.org/projects/kde/kdesdk/okteta/repository/revisions/master/show/kasten/controllers/view/structures/examples/okteta/structures"·target="_top">Git·repository.</a> | 283 | ··········A·few·example·structure·definitions·can·be·found·in·the·<a·class="ulink"·href="https://projects.kde.org/projects/kde/kdesdk/okteta/repository/revisions/master/show/kasten/controllers/view/structures/examples/okteta/structures"·target="_top">Git·repository.</a> |
| 284 | ··········This·includes·for·example·the·file·header·for·PNG·files·and·the·ELF·file·header. | 284 | ··········This·includes·for·example·the·file·header·for·PNG·files·and·the·ELF·file·header. |
| 285 | ··········An·<acronym·class="acronym">XML</acronym>·schema·describing·the·structure·of·the·<code·class="literal">.osd</code>·file·can·be·found··<a·class="ulink"·href="https://projects.kde.org/projects/kde/kdesdk/okteta/repository/revisions/master/show/kasten/controllers/view/structures/schema"·target="_top">here.</a> | 285 | ··········An·<acronym·class="acronym">XML</acronym>·schema·describing·the·structure·of·the·<code·class="literal">.osd</code>·file·can·be·found··<a·class="ulink"·href="https://projects.kde.org/projects/kde/kdesdk/okteta/repository/revisions/master/show/kasten/controllers/view/structures/schema"·target="_top">here.</a> |
| 286 | ··········If·more·information·is·needed·feel·free·to·contact·me·at·<code·class="email">(alex.richardson·AT·gmx.de)</code> | 286 | ··········If·more·information·is·needed·feel·free·to·contact·me·at·<code·class="email">(alex.richardson·AT·gmx.de)</code> |
| 287 | ········</p></div></div></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="tools.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="interface-overview.html">Next</a></td></tr><tr><td·class="prevCell">Tools </td><td·class="upCell">Tools</td><td·class="nextCell"> Interface·Overview</td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="usage-basics.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="tools-structures.html">Next</a></td></tr><tr><td·c·✂ | 287 | ········</p></div></div></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="tools.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="interface-overview.html">Next</a></td></tr><tr><td·class="prevCell">Tools </td><td·class="upCell">Tools</td><td·class="nextCell"> Interface·Overview</td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="usage-basics.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="tools-structures.html">Next</a></td></tr><tr><td·c·✂ |
| 288 | chapter·of·the·<acronym·class="acronym">KDE</acronym>·Fundamentals·documentation·<span·class="application">Okteta</span>·has·these·application·specific·menu·entries: | 288 | chapter·of·the·<acronym·class="acronym">KDE</acronym>·Fundamentals·documentation·<span·class="application">Okteta</span>·has·these·application·specific·menu·entries: |
| 289 | </p><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="file-menu"></a>File·Menu</h3></div></div></div><div·class="variablelist"><dl><dt><span·class="term"><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenu">File</span></span>·→·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenuitem">New</span></span>·(<span·class="shortcut"><strong><span·class="keycap"><strong>Ctrl</strong></span>+<span·class="keycap"><strong>N</strong></span></strong></span>)</span></dt><dd><p><span·class="action">Create·a·new·byte·array...</span></p><div·class="itemizedlist"><ul·class="itemizedlist"·type="disc"><li·class="listitem"><p><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenuitem">Empty</span></span>:·...·as·Empty·one.</p></li><li·class="listitem"><p><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenuitem">From·Clipboard</span></spa·✂ | 289 | </p><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="file-menu"></a>File·Menu</h3></div></div></div><div·class="variablelist"><dl><dt><span·class="term"><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenu">File</span></span>·→·<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenuitem">New</span></span>·(<span·class="shortcut"><strong><span·class="keycap"><strong>Ctrl</strong></span>+<span·class="keycap"><strong>N</strong></span></strong></span>)</span></dt><dd><p><span·class="action">Create·a·new·byte·array...</span></p><div·class="itemizedlist"><ul·class="itemizedlist"·type="disc"><li·class="listitem"><p><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenuitem">Empty</span></span>:·...·as·Empty·one.</p></li><li·class="listitem"><p><span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guimenuitem">From·Clipboard</span></spa·✂ |