Skip to content

Text dokumentu ​

Každý dokument ourCADu je uvnitř zapsaný jako text: seznam prvků s jejich parametry, náčrty, proměnné a konfigurace. Stejný text nese soubor .ourcad i historie verzí. Okno Text dokumentu ho ukáže přímo v editoru, živě a provázaně s modelem.

V textu jdou měnit hodnoty: parametry prvků, názvy, potlačení a proměnné. Úprava se do modelu zapíše až na povel — viz Úpravy textem.

Okno Text dokumentu — blok vybraného prvku je zvýrazněný, šedě jsou pole, která dopočítává server

Jak okno otevřít ​

Ve stromu prvků klikni pravým tlačítkem na řádek s názvem dokumentu a zvol Text dokumentu (.ourcad)…. Okno se dá přetáhnout za titulek a zvětšit tažením za pravý dolní roh; model pod ním zůstává ovladatelný.

Okno otevře i příkaz text v příkazové řádce.

Co v okně je ​

  • Hlavička dokumentu — název, vlastník, verze, stav. Tahle pole patří k dokumentu, ne k postupu, a jsou šedě.
  • features — prvky v pořadí stromu. Každý začíná řádkem - id: … a nese typ, název a parametry. Náčrt má navíc blok sketch: prvky (elements), kóty (dimensions) a vazby (constraints). Kóta nese typ, prvky, ke kterým patří, a hodnotu (value), případně výraz (expression).
  • variables, configurations — proměnné a konfigurace, pokud je dokument má.
  • Šedá pole dopočítává server při každém přepočtu (otisk geometrie, body profilu, odkazy na plochy a hrany, pořadí). Dlouhé úseky takových polí a seznam závislostí jsou sbalené; rozbalíš je šipkou u čísla řádku.

Přesný popis polí je na stránce Formát .ourcad.

Sbalování ​

U čísel řádků jsou šipky: kliknutím sbalíš nebo rozbalíš blok — prvek, jeho parametry, náčrt i celou sekci. Sbalený prvek ukazuje svůj název a typ, takže sbalený text se čte jako seznam prvků.

  • Sbalit prvky v záhlaví okna sbalí každý prvek na jeden řádek. Hodí se pro rychlý přehled a pro přesouvání bloků.
  • Rozbalit vše vrátí celý text.
  • Kliknutí na štítek sbaleného bloku ho rozbalí.

Sbalené prvky — každý na jednom řádku s názvem a typem

Provázání s modelem ​

  • Výběr prvku ve stromu nebo ve scéně posune text na jeho blok a zvýrazní ho.
  • Kliknutí do bloku v textu vybere prvek v editoru.
  • Najetí myší na id (dlouhý kód s pomlčkami) ukáže název a typ prvku, na který odkazuje — třeba u sketch_id ve vysunutí.
  • Změny se propisují samy. Když upravíš rozměr, přidáš prvek nebo model změní kolega, text se do pár vteřin obnoví. Posun okna i sbalené úseky zůstanou. Tlačítko Obnovit načte text hned.

Úpravy textem ​

Kdo smí dokument upravovat, může v okně přepsat:

  • hodnotu parametru prvku — číslo, text nebo ano/ne (width: 40 → width: 80),
  • název prvku (name:),
  • potlačení (suppressed: true),
  • proměnné v sekci variables — hodnotu, výraz, poznámku, i přidat nebo smazat proměnnou,
  • konfigurace v sekci configurations — přidat, smazat, změnit přepsané hodnoty (overrides), popis a potlačené prvky (suppressed_features, seznam id prvků),
  • aktivní konfiguraci — řádek active_configuration: Název na konci textu; smazáním řádku se dokument vrátí k základu.

Po změně proměnných nebo konfigurací se přepíšou kóty náčrtů řízené výrazem, prvky se potlačí nebo obnoví podle aktivní konfigurace a model se přepočítá. Tyhle změny ukládá server, proto je nevrací Zpět.

yaml
configurations:
    - name: Dlouhá
      overrides:
        D: 80
active_configuration: Dlouhá

A měnit strom prvků:

  • smazat prvek — smaž jeho blok (od řádku - id: po další - id:). Když na něm závisí prvek, který na něj odkazuje parametrem (vysunutí na náčrt přes sketch_id), smaž i ten; jinak okno ohlásí odkaz do prázdna. Ostatní závislé prvky se smažou s ním a přehled je vyjmenuje.
  • přesunout prvek — přesuň celý jeho blok jinam mezi ostatní.
  • vepsat nový prvek — napiš blok bez řádku id, id přidělí ourCAD. Jde to u základních těles (box, cylinder, sphere, cone, torus) a u náčrtu bez vazeb a kót:
yaml
    - type: box
      name: Podložka
      parameters:
        width: 60
        height: 40
        depth: 5

Postup:

  1. Přepiš, co potřebuješ. Model se zatím nemění; v záhlaví okna se objeví Použít a Zahodit.
  2. Použít (nebo Ctrl/Cmd+Enter) ukáže přehled změn, například Kvádr · width: 40 → 80.
  3. Provést změny zapíše. Model se přepočítá stejně jako po úpravě v dialogu a krok jde vrátit přes Zpět (Ctrl/Cmd+Z, když je kurzor mimo text).

Co je dobré vědět:

  • Chyba nic nezmění. Překlep v klíči, text místo čísla nebo úprava pole, které měnit nejde, se vypíše nad textem s číslem řádku a řádek se podbarví. Dokud hlášení nezmizí, nic se nezapíše.
  • Šedá pole měnit nejde — dopočítává je server.
  • Mazání vždy uvidíš předem. Přehled před provedením červeně uvede, kolik prvků se smaže, včetně závislých.
  • Kóta náčrtu: v bloku dimensions přepiš value (nebo expression, když má kótu řídit výraz s proměnnými). Po provedení se náčrt přeřeší podle svých vazeb a prvky, které z něj vycházejí, se přepočítají — jako po přepsání kóty v editoru náčrtu, včetně kroku Zpět.
    • Hodnotu kóty řízené výrazem přepsat nejde; přepiš výraz, nebo řádek expression smaž.
    • Když nová hodnota odporuje ostatním vazbám, okno to ohlásí a nic se nezmění.
  • Obsah náčrtu: v bloku sketch jde přepsat i všechno ostatní — souřadnice prvků, přidat nebo smazat prvek, vazbu i kótu. Podrobnosti v oddíle Úprava náčrtu textem.
  • Vysunutí, díru, zaoblení a další prvky, které vznikají výpočtem, textem založit nejde — použij příkazovou řádku nebo dialog. Konfigurace textem upravit nejdou.
  • Strom jde měnit jen nad stavem, který vidíš. Když mezitím někdo prvek přidal, smazal nebo přesunul, okno změnu stromu odmítne a požádá o nové načtení textu. Hodnoty se přitom použijí normálně.
  • Když mezitím model změní kolega (nebo ty v dialogu), rozepsaný text zůstane a okno na to upozorní. Tvoje úpravy se použijí na aktuální stav: co jsi nezměnil, zůstane podle kolegy. Jen když jste změnili tentýž parametr nebo název, okno ohlásí konflikt a nic nezapíše. Pak se rozhodneš: Zahodit načte kolegův stav, Použít moje hodnoty nechá platit tvoji úpravu — přehled před provedením označí, které jeho změny tím přepíšeš.
  • Zahodit vrátí text k živému stavu.

Úprava náčrtu textem ​

Blok sketch náčrtu má tři seznamy: prvky (elements), kóty (dimensions) a vazby (constraints). Všechny tři jde v okně upravit; po Použít okno ukáže, kolik prvků, vazeb a kót přibylo, ubylo a změnilo se.

yaml
sketch:
  elements:
  - id: otvor               # nový prvek: id si zvol sám, nebo ho vynech
    type: circle
    geometry:
      points: [15, 6, 2]    # střed X, střed Y, poloměr
  dimensions:
  - type: diameter          # nová kóta: bez id, přidělí ho ourCAD
    element_ids: [otvor]
    value: 6
  • Vazby mají přednost před souřadnicemi. Po provedení se náčrt přeřeší. Když přepíšeš souřadnici, kterou drží kóta nebo vazba, vrátí se na místo — chceš-li tvar změnit, uprav kótu nebo vazbu. Souřadnice proto u nového prvku stačí zadat přibližně a polohu určit kótami. Co žádná vazba nedrží (třeba konce volného oblouku), si řešič smí posunout.
  • Nový prvek je line (points: [x1, y1, x2, y2]), circle ([střed X, střed Y, poloměr]), arc ([střed X, střed Y, poloměr, počáteční úhel, koncový úhel] v radiánech) nebo point ([x, y]). Dej mu vlastní krátké id, ať se na něj můžeš odkázat z kóty nebo vazby; bez odkazu ho vynech. Elipsy, spline a další křivky v náčrtu zůstanou, ale textem je přidat ani měnit nejde.
  • Nová kóta nebo vazba se píše bez id. V element_ids uveď prvky, v point_indices jejich body (úsečka: 0 začátek, 1 konec; oblouk: 0 střed, 1 začátek, 2 konec; kružnice a bod: 0) — u celého prvku point_indices vynech. Typy vazeb a kót vypisuje stránka Formát .ourcad.
  • Smazání prvku: smaž jeho položku a s ní i kóty a vazby, které na něj odkazují; jinak okno ohlásí odkaz na neexistující prvek.
  • Kóty v rozporu (dvě kóty, které nejdou splnit zároveň) okno po Provést ohlásí a náčrt nechá, jak byl.
  • Kopie náčrtu: zkopíruj celý blok náčrtu, smaž v kopii řádek id prvku (ten první, ne id prvků náčrtu) a dej jí jiný název. Kopie dostane vlastní id prvků, vazeb i kót a vazby se na ně přepíšou.
  • Když náčrt mezitím změnil někdo jiný, okno úpravu odmítne a požádá o nové načtení textu. (Samotná hodnota kóty se sloučí — viz výše.)
  • Všechno jde vrátit přes Zpět jedním krokem.

Hledání ​

Tlačítko Hledat (nebo Ctrl/Cmd+F, když je kurzor v textu) otevře hledání s volbami pro velikost písmen, celá slova a regulární výrazy. Hodí se pro dohledání prvku podle názvu nebo všech míst, kde se používá jedna proměnná.

K čemu to je ​

  • Kontrola, co se opravdu uloží — text v okně je přesně to, co nese soubor .ourcad a co se zapisuje do historie.
  • Hledání příčiny chyby — u prvku, který se nepřepočítá, je vidět, na jaký náčrt nebo těleso odkazuje a s jakými hodnotami.
  • Porovnání s verzí — stejný zápis ukazuje rozdíl mezi verzemi v historii.

Velké sestavy

Text ukazuje právě otevřený dokument. Díly vložené do sestavy mají vlastní text — otevři díl a okno ukáže ten jeho.

ourCAD — git-native CAD