Нове дефиниције структура најлакше се инсталирају путем подршке за вруће новотарије уграђене у Октети. Да бисте инсталирали постојећу структуру, отворите дијалог поставки алатке за структуре. У њему идите под језичак Управљање структурама и кликните на дугме Добави нове структуре.... Дијалог који се на то појави омогућава вам инсталирање и деинсталирање структура.

Алатка структура тражи описе структура у потфасцикли okteta/structures/ корисничке фасцикле за податке програма̂ (коју налазите извршавањем qtpaths --paths GenericDataLocation). Можда ћете морати да направите ову фасциклу, ако још увек нема ниједне инсталиране дефиниције структуре.

За сваку дефиницију структуре постоје два фајла: један за саму дефиницију, и један .desktop фајл за метаподатке (аутор, верзија, итд.).

У наведеној фасцикли, свака дефиниција структуре има своју потфасциклу која садржи и .desktop и .osd или main.js фајл дефиниције.

На пример, ако је фасцикла података програма̂ qtpaths --paths GenericDataLocation а име дефиниције структуре PrimerStrukture, онда постоји фасцикла okteta/structures/ExampleStructure која садржи фајлове PrimerStrukture.desktop и PrimerStrukture.osd.

Пошто инсталирате нову дефиницију структуре, да бисте је користили морате поново покренути Октету. Пошто то учините, отворите дијалог поставки алатке за структуре. Идите на језичак Управљање структурама и обезбедите да је одговарајућа дефиниција структуре активирана. Затим пређите на језичак Структуре и проверите да ли је жељени елемент приказан на десној страни.

Наш фајл са метаподацима изгледа овако:

        [Desktop Entry]
        Encoding=UTF-8
        Icon=arrow-up❶
        Type=Service
        ServiceTypes=KPluginInfo

        Name=Simple test structure
        Comment=A very simple test structure containing only two items

        X-KDE-PluginInfo-Author=Pera Peric
        X-KDE-PluginInfo-Email=pera.peric@nikadodjija.org
        X-KDE-PluginInfo-Name=simplestruct
        X-KDE-PluginInfo-Version=1.0
        X-KDE-PluginInfo-Website=http://www.nikadodjija.org/plugins/
        X-KDE-PluginInfo-Category=structure
        X-KDE-PluginInfo-License=LGPL
        X-KDE-PluginInfo-EnabledByDefault=false
        

Сва поља би требало да су прилично очигледна, осим X-KDE-PluginInfo-Name. Вредност овог поља мора бити једнака имену фасцикле која садржи фајл, као и имену .desktop фајла. Ако се прави ИксМЛ дефиниција структуре, и име .osd фајла мора бити једнако овоме.

У овом примеру имали бисмо фасциклу по имену simplestruct, која садржи фајл simplestruct.desktop. Ако се структура дефинише ИксМЛ‑ом, фасцикла би такође садржала фајл simplestruct.osd. Ако бисмо користили јаваскрипт, фајл дефиниције би се уместо тога звао main.js.

За почетак дефинишимо врло једноставну пробну структуру која садржи само интегралне типове података (један знак, један 32‑битни означени цео број и једно битско поље). У Ц‑у или Ц++у ово би се изразило као:

          struct simple {
            char aChar;
            int anInt;
            bool bitFlag :1;
            unsigned padding :7;
          };
          

Први корак је писање .osd фајла, формата дефинисаног у претходном одељку. Назваћемо га simplestruct.osd:

          <?xml version="1.0" encoding="UTF-8"?>
          <data>
            <struct name="simple">
              <primitive name="aChar" type="Char"/>
              <primitive name="anInt" type="Int32"/>
              <bitfield name="bitFlag" type="bool" width="1"/>
              <bitfield name="padding" type="unsigned" width="7"/>
            </struct>
          </data>
          

Ово је сасвим слично дефиницији у Ц‑у и Ц++у

Направите фасциклу simplestruct унутар инсталационе фасцикле структура (погледајте одељак о ручном инсталирању дефиниција) и копирајте у њу ова два фајла. Сада можете поново покренути Октету и користити нову структуру.

Да бисмо извели исту структуру помоћу јаваскрипта, направимо фајл по имену main.js (уместо претходног simplestruct.osd) и променимо X-KDE-PluginInfo-Category=structure у X-KDE-PluginInfo-Category=structure/js. Фајл треба да има следећи садржај:

        function init() {
          var structure = struct({
            aChar : char(),
            anInt : int32(),
            bitFlag : bitfield("bool", 1),
            padding : bitfield("unsigned", 7),
          })
          return structure;
        }
        

Структура коју приказује Октета увек је повратна вредност функције init.

Следеће функције се могу позивати ради стварања примитивних типова:

Функција bitfield узима два аргумента. Први је ниска "bool", "signed" или "unsigned". Други аргумент је цео број којим се задаје ширина у битовима.

Прелазимо на дефинисање сложеније структуре, коју ћемо назвати complex и сачувати у фајл по имену complex.osd. Ова структура ће садржати два низа (један фиксне дужине а други коме се дужина одређује при извршавању), као и угнежђену структуру и унију.

          <?xml version="1.0" encoding="UTF-8"?>
          <data>
            <struct name="complex">
              <primitive name="size" type="UInt8" />
              <union name="aUnion">
                <array name="fourBytes" length="4">
                  <primitive type="Int8" />
                </array>
              </union>
              <struct name="nested">
                <array name="string" length="size"> <!-- references the field size above -->
                  <primitive type="Char" />
                </array>
              </struct>
            </struct>
          </data>
          

Ово би одговарало следећем у псеудо‑Ц‑у/Ц++у:

struct complex {
            uint8_t size;
            union aUnion {
              int8_t fourBytes[4];
            };
            struct nested {
              char string[size]; // није правилан Ц++, упућује на вредност uint8 size
            };
          };
          

Затим правимо фајл complex.desktop као у претходном примеру (не заборавите да исправно задате X-KDE-PluginInfo-Name) и на исти начин инсталирамо оба фајла.

Неколико примера дефиниција структура може се наћи гит ризници. Међу њима су, на пример, дефиниције заглавље ПНГ и ЕЛФ фајлова. ИксМЛ шема која описује структуру .osd фајла такође се налази у ризници. За још информација можете писати на (arichardson.kde gmail.com).