= Python OCC =

[[PageOutline]] 
PythonOCC omogoča enostavnejšo uporabo jedra modelirnika OpenCascade v jeziku Python.
Prednost Pythona v primerjavi z C++ je:
 - Prenosljivosti. Programi se interpretirajo in jih ni potrebno prevajati zato delujejo na vseh operacijskih sistemih. So pa nekoliko počasnejši.
 - Enostavnejša namestitev potrebnih knjižnic, brez zahtevne konfiguracije povezovalnih parametrov, ki so značilni za C++.
 - Lažje učenje jezika. V interaktivnem načinu obstaja tudi refleksija oziroma dinamično prepoznavanje možnih ukazov v objektu.

Za vaje je potrebno na Windowsih (tudi 64 bitnih) namestiti naslednje pakete:
 1. [http://python.org/ftp/python/2.6.6/python-2.6.6.msi Python 2.6] interpreter jezika z osnovnimi knjižnicami
 2. [http://downloads.sourceforge.net/wxpython/wxPython2.8-win32-unicode-2.8.12.1-py26.exe wxPython] za opravljanje z okni
 3. [http://pythonocc.googlecode.com/files/pythonOCC-0.5-win32-all-in-one-py26.exe PythonOCC] povezava Pytona z jedrom OpenCascade 

Neobvezno vendar priporočljivo je namesti še:
 1. [http://archive.ipython.org/release/0.11/ipython-0.11.win32-setup.exe iPython] za interektivno delo
 2. [http://downloads.sourceforge.net/project/numpy/NumPy/1.6.1/numpy-1.6.1-win32-superpack-python2.6.exe NumPy] za delo z numeričnimi metodami in matrikami.
 3. [http://downloads.sourceforge.net/project/scipy/scipy/0.10.0b2/scipy-0.10.0b2-win32-superpack-python2.6.exe SciPy] za delo z znanstvenimi algoritmi.

Pred preizkusom prvih primerov je potrebno nastaviti še pot do interpreterja  v ''Moj računalnik -> Lastnosti -> Dodatne nastavitve sistema -> Spremenljivke okolja ... -> Sistemske spremenljivke -> Path -> Uredi -> Vrednost spremeljivke'': in na koncu dodamo `;c:\Python26;`. Po tem je potremn računalnik ''vnovič zagnati''.

V primeru, da nam klik na ''Start->Vsi programi->pythonOCC -> Examples -> Level1 -> !HelloWorld -> helloworld.py'' okno na hitro odpre, vendar modela ne prikaže, imamo težave z OpenGL krmilniki. Najenostavneje težavo odpravimo s spremembo osnovnega prikazovalnika v datoteki `C:\Python26\Lib\site-packages\OCC\Display\wxDisplay.py` v kateri platformo `darwin` poistovetimo z `win32` tako da del kode v tej datoteki izgleda:
{{{
#!python
if sys.platform=='win32':
    BaseClass = wx.Panel
else:
    import wx.glcanvas
    BaseClass = wx.glcanvas.GLCanvas
}}}
V primeru, da nam namestitveni program nepravilno namesti imenik na {{{C:\OCC}}} ga prestavimo v podimenik {{{C:\Python26\Lib\site-packages}}}
----

== Struktura programa v Python OCC ==

Rabimo uvoziti uporabniški vmesnik, ki nam omogoči preprosto manipulacijo 
predstavljenega objekta (glava dokumenta):
{{{
#!python
from OCC.Display.SimpleGui import *
}}}
Z ukazno vrstico uvozimo v program knjižnico, ki vsebuje modelno okno ter preprosti uporabniški vmesnik, ki ga lahko uporabimo za prikaz različnih geometrijskih oblik v 3D okolju.
[[BR]][[BR]]

Uvedba funkcij za iniciacijo prikaza:
{{{
#!python
display, start_display, add_menu, add_function_to_menu = init_display()
}}}
Z ukazno vrstico uvedemo v program prikaz v modelnem oknu ter možnost uporabe preprostega menija.
[[BR]][[BR]]

Iniciacija prikaznega okna:
{{{
#!python
start_display()
}}}
S tem ukazom iniciramo modelno okno. Definicija uporabljenih geometrijskih oblik mora biti podana preden se ukaz izvede.[[Image(display.png, right)]]
[[BR]][[BR]][[BR]][[BR]]

Uporaba miške v uporabniškem vmesniku:
 * Rotacija objekta: levi gumb na miški
 * Translacija objekta: srednji gumb na miški
 * Povečava objekta: desni gumb na miški, premik levo-desno
[[BR]]

Uporaba tipkovnice v uporabniškem vmesniku:
 * Tipka'w'- prikaz žičnega modela
 * Tipka 'e'- prikaz vidnih robov
 * Tipka 's'- prikaz volumskega modela
 * Tipka 'f'- prikaz celega objekta v prikaznem oknu
 * Tipka 'q'- prikaz vidnih robov
[[BR]][[BR]][[BR]][[BR]][[BR]]


Za izdelavo modela v okolju Python OCC je potrebna predhodna uvedba knjižnic OpenCascade (OCC), ki vsebujejo različne nabore ukazov:
{{{
#!python
from OCC.Display.SimpleGui import *  # Knjižnica z modelnim oknom ter uporabniškim vmesnikom (GUI)
from OCC.gp import *                 # Knjižnica z naborom osnovnih gradnikov -točk
from OCC.GC import *                 # 
from OCC.TopoDS import *             # Knjižnica z naborom topoloških gradnikov (krivulje,...)
from OCC.BRepBuilderAPI import *     # Knjižnica z naborom osnovnih gradnikov skice (vozlišča, robovi, segmenti, mreže ...)
from OCC.BRepPrimAPI import *        # Knjižnica z naborom osnovnih geometrijskih primitivov
from OCC.BRepFilletAPI import *      # Knjižnica z naborom orodij za izdelavo zaokrožitev
}}}
V program uvedemo zgolj knjižnice, ki jih tudi rabimo za učinkovito delovanje.
[[BR]][[BR]][[BR]]
----


== Preprosti program- Primer izdelave izvleka v prostor (Extrude) ==

Primer izdelave kocke z dimenzijami 10x10x10. Postopek modeliranja v [[Image(Kocka.png, right)]]
komercialnih modelirnikih (SolidWorks, Catia, NX, ProEngineer, Inventor,...)
je sledeči:
 * izbira ravnine, na katero se nariše skica[[BR]][[BR]]
 * izris oblike skice (kvadrat)[[BR]][[BR]]
 * definiranje skice (dimenzije, geometrijske relacije, pozicija v prostoru)[[BR]][[BR]]
 * izbira ustrezne značilke za izdelavo 3D objekta (Izvlek- Extrude)[[BR]][[BR]]
 * določitev parametrov izvleka (smer, dolžina izvleka)[[BR]][[BR]]
 * model je zmodeliran
[[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]]

V okolju Python OCC poteka izris objekta nekoliko drugače. Razložen je 
preprosti postopek izdelave kocke, ki poteka v večih korakih. Pri izdelavi
je potrebno manualno določiti vse parametre, ki jih komercialni modelirnik
običajno določi namesto nas.[[BR]][[BR]]

Korak 01: Izdelava točke v prostoru [[Image(Vozlisca.png, right)]]
Razlaga ukaza za izdelavo točke [http://opencascade.sourcearchive.com/documentation/6.3.0.dfsg.1/classgp__Pnt.html gp__Pnt]
{{{
#!python
Tocka = gp_Pnt(x_1 , y_1 , z_1)
}}}
Iz določenih točk lahko naredimo vozlišča. Detajlna razlaga uporabljenega ukaza: [http://opencascade.sourcearchive.com/documentation/6.3.0.dfsg.1/classBRepLib__MakeVertex.html BRepBuilderAPI__MakeVertex].
{{{
#!python
Vozlisce = BRepBuilderAPI_MakeVertex(Tocka)
}}}
Če hočemo prikazati vozlišča v modelnem oknu, potem je potrebno napisati ukaz za prikaz oblike:
{{{
#!python
display.DisplayShape(Vozlisce.Shape())
}}}
[[BR]][[BR]][[BR]][[BR]][[BR]][[BR]]


Korak 02: Izdelava robov iz točk [[Image(Robovi.png, right)]]
{{{
#!python
Rob = BRepBuilderAPI_MakeEdge(Zacetna_tocka, Koncna_tocka)
}}}
Za izdelavo roba rabimo dva podatka, to je začetna točka ter končna točka robu. Detajlna razlaga 
uporabljenega ukaza: [http://opencascade.sourcearchive.com/documentation/6.3.0.dfsg.1/classBRepLib__MakeEdge.html BRepBuilderAPI__MakeEdge]. Če hočemo 
prikazati izdelani rob v modelnem oknu, je potrebno zapisati ukaz:
{{{
#!python
display.DisplayShape(Rob.Shape())
}}}
[[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]]

Korak 03: Izdelava mrežnega modela iz točk [[Image(Wire.png, right)]]
{{{
#!python
Mreza  = BRepBuilderAPI_MakeWire(Rob1.Edge() , Rob2.Edge() ,Rob3.Edge(), Rob4.Edge())
Mreza2  = BRepBuilderAPI_MakeWire(Mreza.Wire(), Rob1.Edge())
}}}
Vsak rob predstavlja svojo geometrijsko obliko v prostoru. Zato moramo, preden naredimo
površino te robove združiti v eno samo geometrijo. Pozorni moramo biti, da robovi tvorijo
zaprto obliko. Ukaz nam dovoli sočasno uporabo štirih argumentov- robov. Pri tem moramo
označiti, da gre za obliko roba [Rob.Edge()]. Kot rezultat dobimo združeno mrežo. Detajlna 
razlaga uporabljenega ukaza: [http://opencascade.sourcearchive.com/documentation/6.3.0.dfsg.1/classBRepBuilderAPI__MakeWire.html BRepBuilderAPI__MakeWire]
Če hočemo prikazati izdelani rob v modelnem oknu, je potrebno zapisati ukaz:
{{{
#!python
display.DisplayShape(Mreza.Shape())
}}}
[[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]]

Korak 04: Izdelava površine iz obstoječe mreže [[Image(Povrsina.png, right)]]
{{{
#!python
Povrsina = BRepBuilderAPI_MakeFace(Mreza.Wire())
}}}
Iz obstoječega zaprtega lika, ki je planaren lahko tvorimo površino. Detajlna razlaga 
uporabljenega ukaza: [http://opencascade.sourcearchive.com/documentation/6.3.0.dfsg.1/classBRepBuilderAPI__MakeFace.html BRepBuilderAPI__MakeFace]
Če hočemo prikazati izdelani rob v modelnem oknu, je potrebno zapisati ukaz:
{{{
#!python
display.DisplayShape(Povrsina.Shape())
}}}
[[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]]

Korak 05: Izdelava izvleka v prostor [[Image(Solid.png, right)]]
Izdelano površino lahko uporabimo za izdelavo tridimenzionalne oblike. Če hočemo narediti 
izvlek, je potrebno najprej določiti še parametre vičine izvleka. V ta namen določimo vektor, 
ki vsebuje podatek o velikosti in smeri izvleka. Razlaga uporabljenega ukaza: [http://opencascade.sourcearchive.com/documentation/6.3.0.dfsg.1/classgp__Vec.html gp_Vec].
{{{
#!python
Vektor = gp_Vec(Velikost_X , Velikost_Y, Velikost_Z)
}}}
Sledi uporaba ukaza za izdelavo izvleka. Pri tem je potrebno uporabiti podatek o površini ter 
izdelani vektor. Če hočemo, lahko naredimo tudi neskončno dolgi izvlek v prostor, tako da uporabimo 
zgolj podatek o izbrani smeri namesto določenega vektorja (uporaba pri Boolovi operaciji odštevanja).
Razlaga uporabljenega ukaza: [http://opencascade.sourcearchive.com/documentation/6.3.0.dfsg.1/classBRepFeat__MakePrism.html BRepFeat__MakePrism].
{{{
#!python
Izvlek = BRepPrimAPI_MakePrism(Povrsina.Face() , Vektor)
Izvlek = BRepPrimAPI_MakePrism(Povrsina.Face() , Smer)
}}}
[[BR]][[BR]][[BR]][[BR]][[BR]]

Barvo modela lhako po želji spremenimo z uporabo ukaza:
{{{
#!python
display.DisplayColoredShape(Oblika.Shape(), 'BARVA')
}}}
[[BR]][[BR]]

Primer programa za izdelavo izvleka:[[Image(Solid-barve.png, right)]]
{{{
#!python
## Izdelava Izvleka

from OCC.Display.SimpleGui import * 
from OCC.BRepPrimAPI import *
from OCC.gp import *
from OCC.GC import *
from OCC.BRepBuilderAPI import *

display, start_display, add_menu, add_function_to_menu = init_display()

#Izdelava točk v prostoru
T1 = gp_Pnt(0 , 0 , 0)
T2 = gp_Pnt(10 , 0, 0)
T3 = gp_Pnt(10 , 10 , 0)
T4 = gp_Pnt(0, 10 , 0)

#izdelava robov na podlagi definiranih tock
E1 = BRepBuilderAPI_MakeEdge(T1, T2)
E2 = BRepBuilderAPI_MakeEdge(T2, T3)
E3 = BRepBuilderAPI_MakeEdge(T3, T4)
E4 = BRepBuilderAPI_MakeEdge(T4, T1)

#izdelava mreznega modela
Mreza  = BRepBuilderAPI_MakeWire(E1.Edge() , E2.Edge() ,E3.Edge(), E4.Edge())

#Izdelava povrsine
Povrsina = BRepBuilderAPI_MakeFace(Mreza.Wire())

#Izdelava vektorja za izvlek v prostor
Vektor1 = gp_Vec(0 , 0, 10)

#Izdelava priznaticnega telesa- izvlek povrsine v smeri vektorja
Izvlek = BRepPrimAPI_MakePrism(Povrsina.Face() , Vektor1)

#Prikaz izvleka v prikaznem oknu
display.DisplayShape(Izvlek.Shape())

#Sprememba barve modela
display.DisplayColoredShape(Izvlek.Shape(), 'RED')

display.View_Iso() #izometricni prikaz
start_display()
}}}
----


== Uporaba geometrijskih primitivov ==

=== Izdelava kvadra ===
[[Image(Kvader.png, right)]]
{{{
#!python
kvader = BRepPrimAPI_MakeBox(dolzina_X, dolzina_Y, dolzina_Z)
kvader = BRepPrimAPI_MakeBox(Tocka1, dolzina_X, dolzina_Y, dolzina_Z)
kvader = BRepPrimAPI_MakeBox(Tocka1, Tocka2)
}}}
Z ukazom [http://opencascade.sourcearchive.com/documentation/6.3.0.dfsg.1/classBRepPrimAPI__MakeBox.html BRepPrimAPI__MakeBox] izdelamo tridimenzionalni model oblike kvadra. Pri tem lahko uporabimo več različnih argumentov:
 * (dolzina_X, dolzina_Y, dolzina_Z) ... kvader določimo z razdaljami posameznih robov[[BR]][[BR]]
 * (Tocka1, dolzina_X, dolzina_Y, dolzina_Z) ... kvader se prične izrisovati od točke 1 (X,Y,Z) dalje inje določen z razdaljami posameznih robov[[BR]][[BR]]
 * (Tocka 1, Tocka2) ... kvader določimo s koordinatami dveh točk, ki ježita v nasproti ležečih ogliščih
[[BR]][[BR]][[BR]][[BR]]


=== Izdelava izvleka pod kotom nagiba ===
[[Image(Kvader-nagib.png, right)]]
{{{
#!python
kvader= BRepPrimAPI_MakeWedge(dolzina_X, dolzina_Y, dolzina_Z, dolzina_X2)
kvader= BRepPrimAPI_MakeWedge(dolzina_X, dolzina_Y, dolzina_Z, dolzina_Xmin, dolzina_Zmin, dolzina_Xmax, dolzina_Zmax)
kvader= BRepPrimAPI_MakeWedge(dolzina_X, dolzina_Y, dolzina_Z, dolzina_X/2, 0, dolzina_X/2, dolzina_Z)
kvader= BRepPrimAPI_MakeWedge(dolzina_X, dolzina_Y, dolzina_Z, dolzina_X/2, dolzina_Z/2, dolzina_X/2, dolzina_Z/2)
}}}
Z ukazom [http://opencascade.sourcearchive.com/documentation/6.3.0.dfsg.1/classBRepPrimAPI__MakeWedge.html BRepPrimAPI__MakeWedge] izdelamo tridimenzionalni model oblike kvadra s koti nagiba. Pri tem lahko uporabimo več različnih argumentov:
 * (dolzina_X, dolzina_Y, dolzina_Z, dolzina_X2) ... določimo razdalje posameznih robov kvadra, ter dimenzijo spremenjenega roba X[[BR]][[BR]]
 * (dolzina_X, dolzina_Y, dolzina_Z, dolzina_Xmin, dolzina_Zmin, dolzina_Xmax, dolzina_Zmax) ... določimo razdalje posameznih robov kvadra, ter minimalne in maksimalne dimenzije robov X in Z
 * (dolzina_X, dolzina_Y, dolzina_Z, dolzina_X/2, 0, dolzina_X/2, dolzina_Z) ... določimo razdalje posameznih robov kvadra, ter dimenzijo spremenjenega roba Z[[BR]][[BR]]
 * (dolzina_X, dolzina_Y, dolzina_Z, dolzina_X/2, dolzina_Z/2, dolzina_X/2, dolzina_Z/2)... določimo razdalje posameznih robov kvadra, preostali argumenti nam podajo obliko piramide
[[BR]]


=== Izdelava valja ===
[[Image(Valj.png, right)]]
{{{
#!python
valj= BRepPrimAPI_MakeCylinder(Radij, Visina, Kot_radiani)
valj= BRepPrimAPI_MakeCylinder(Os, Radij, Visina, Kot_radiani)
}}}
Z ukazom [http://opencascade.sourcearchive.com/documentation/6.3.0.dfsg.1/classBRepPrimAPI__MakeCylinder.html BRepPrimAPI__MakeCylinder] izdelamo tridimenzionalni model oblike valja. Pri tem lahko uporabimo več različnih argumentov:
 * (Radij, Visina) ... izdelamo valj z določenim radijem in višino
 * (Radij, Visina, Kot_radiani) ... izdelamo delj valja za nastavljen kot z določenim radijem in višino
 * (Os, Radij, Visina, Kot_radiani) ... izdelamo delj valja za nastavljen kot z določenim radijem in višino in ki ima nastavljeno poljubno os
Os valja definiramo kot:
{{{
#!python
Tocka = gp_Pnt(X, Y, Z)         #definicija tocke
normala = gp_DX()               #smer normale
os = gp_Ax2(Tocka, normala)     #definicija osi
}}}
[[BR]][[BR]]


=== Izdelava stožca ===
[[Image(Stozec.png, right)]]
{{{
#!python
stozec= BRepPrimAPI_MakeCone(Radij_1, Radij_2, Visina, Kot_radiani)
stozec= BRepPrimAPI_MakeCone(Os, Radij_1, Radij_2, Visina, Kot_radiani)
}}}
Z ukazom [http://opencascade.sourcearchive.com/documentation/6.3.0.dfsg.1/classBRepPrimAPI__MakeCone.html BRepPrimAPI__MakeCone] izdelamo tridimenzionalni model oblike stožca. Pri tem lahko uporabimo več različnih argumentov:
 * (Radij_1, Radij_2, Visina) ... izdelamo stožec z osnovo radija 1 ter na višini H z radijem 2[[BR]][[BR]]
 * (Radij_1, Radij_2, Visina, Kot_radiani) ... izdelamo delni stožec, določen s kotom, z osnovo radija 1 ter na višini H z radijem 2[[BR]][[BR]]
 * (Os, Radij_1, Radij_2, Visina, Kot_radiani) ... izdelamo delni stožec okoli izbrane osi, določen s kotom, z osnovo radija 1 ter na višini H z radijem 2
[[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]]


=== Izdelava sfere ===
[[Image(Sfera.png, right)]]
{{{
#!python
sphere= BRepPrimAPI_MakeSphere(Radij, Kot_radiani)
sphere= BRepPrimAPI_MakeSphere(Radij, Kot_a1_rad, Kot_a2_rad)
sphere= BRepPrimAPI_MakeSphere(Radij, Kot_a1_rad, Kot_a2_rad, Kot_radiani)
}}}
Z ukazom [http://opencascade.sourcearchive.com/documentation/6.3.0.dfsg.1/classBRepPrimAPI__MakeSphere.html BRepPrimAPI__MakeSphere] izdelamo tridimenzionalni model oblike sfere. Pri tem lahko uporabimo več različnih argumentov:
 * (Radij) ... izdelave sfere z radijem
 * (Radij, Kot_radiani) ... izdelave delne sfere z radijem
 * (Radij, Kot_a1_rad, Kot_a2_rad) ... izdelave sfere, ki ima odstanjen sredinski del pod kotom 1 in kotom 2[[BR]][[BR]]
 * (Radij, Kot_a1_rad, Kot_a2_rad, Kot_radiani) ... izdelave delne sfere, ki ima odstanjen sredinski del pod kotom 1 in kotom 2
[[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]]

=== Izdelava torusa ===
[[Image(Torus.png, right)]]
{{{
#!python
torus= BRepPrimAPI_MakeTorus(Radij_torusa, Radij_prereza)
torus= BRepPrimAPI_MakeTorus(Radij_torusa, Radij_prereza, Kot_radiani)
torus= BRepPrimAPI_MakeTorus(Radij_torusa, Radij_prereza, Kot_a1_rad, Kot_a2_rad)
}}}
Z ukazom [http://opencascade.sourcearchive.com/documentation/6.3.0.dfsg.1/classBRepPrimAPI__MakeTorus.html BRepPrimAPI__MakeTorus] izdelamo tridimenzionalni model oblike torusa. Pri tem lahko uporabimo več različnih argumentov:
 * (Radij_torusa, Radij_prereza) ... izdelava torusa s središčnim radijem ter polmerom prereza[[BR]][[BR]]
 * (Radij_torusa, Radij_prereza, Kot_radiani) ... izdelava delnega torusa s središčnim radijem ter polmerom prereza[[BR]][[BR]]
 * (Radij_torusa, Radij_prereza, Kot_a1_rad, Kot_a2_rad) ... izdelava delnega torusa, ki ima odstanjen sredinski del pod kotom 1 in kotom 2
[[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]]


=== Izdelava izvleka ===
[[Image(Izvlek_2.png, right)]]
{{{
#!python
Izvlek = BRepPrimAPI_MakePrism(Povrsina , Vektor)
Izvlek = BRepPrimAPI_MakePrism(Povrsina , Smer)
}}}
Z ukazom [http://opencascade.sourcearchive.com/documentation/6.3.0.dfsg.1/classBRepPrimAPI__MakePrism.html BRepPrimAPI__MakePrism] izdelamo tridimenzionalni prizmatični model. Pri tem lahko uporabimo več različnih argumentov:
 * (Povrsina , Vektor) ... izberemo obstoječo površino ter jo izvlečemo za velikost vektorja
 * (Povrsina , Smer) ... izberemo obstoječo površino ter jo izvlečemo v željeni smeri
[[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]]


=== Izdelava krožnega izvleka ===
[[Image(Izvlek_krozni.png, right)]]
{{{
#!python
Vrtenina = BRepPrimAPI_MakeRevol(Povrsina , Os)
Vrtenina = BRepPrimAPI_MakeRevol(Povrsina , Os, Kot_radiani)
}}}
Z ukazom [http://opencascade.sourcearchive.com/documentation/6.3.0.dfsg.1/classBRepPrimAPI__MakeRevol.html BRepPrimAPI__MakeRevol] izdelamo tridimenzionalni osnosimetričnimodel. Pri tem lahko uporabimo več različnih argumentov:
 * (Povrsina , Os) ... zavrtimo izbrano površino okoli osi
 * (Povrsina , Os, Kot_radiani) ... zavrtimo izbrano površino za kot okoli osi
[[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]]
----

== Uporaba menijev znotraj prikaznega okna ==
[[Image(Meniji.png, right)]]

Najprej je potrebno definirati funkcije, ki izvršijo ukaz (izdelajo neko obliko). Pri tem pred izrisom oblike počistimo modelno okno obstoječih oblik z ukazom [display.EraseAll()].
{{{
#!python
def Funkcija(event=None):
    display.EraseAll()
    #definicija prikazane oblike
    display.DisplayShape(Oblika.Shape())
}}}

Izdelava menija
{{{
#!python
add_menu('Ime_menija')
add_function_to_menu('Ime_menija',Funkcija1)
add_function_to_menu('Ime_menija',Funkcija2)
}}}
[[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]]


== Boolova algebra ==
Poznamo tri operacije Boolove algebre: Seštevanje, Odštevanje ter Presek. Za uporabo imamo na voljo knjižnico ukazov BRepAlgoAPI.
{{{
#!python
from OCC.BRepAlgoAPI import *
}}}  
[[BR]][[BR]]

Seštevanje (Fusion) [[Image(20.png, right)]]  [[BR]][[BR]]
Operacija seštevanja objektov se izvaja z uporabo ukaza [http://opencascade.sourcearchive.com/documentation/6.3.0.dfsg.1/classBRepAlgoAPI__Fuse.html BRepAlgoAPI__Fuse], kjer dodamo kot argumente 3D obliki, ki ju želimo združiti:
{{{
#!python
sestevanje = BRepAlgoAPI_Fuse(Oblika1,Oblika2)
}}}
[[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]]


Presek (Common) [[Image(21.png, right)]]  [[BR]][[BR]]
Operacija izdelave preseka objektov se izvaja z uporabo ukaza [http://opencascade.sourcearchive.com/documentation/6.3.0.dfsg.1/classBRepAlgoAPI__Common.html BRepAlgoAPI__Common], kjer dodamo kot argumente 3D obliki, med katerimi želimo poiskati skupni volumen:
{{{
#!python
presek = BRepAlgoAPI_Common(Oblika1,Oblika2)
}}}
[[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]]


Odštevanje (Cut) [[Image(22.png, right)]]  [[BR]][[BR]]
Operacija odštevanjaobjektov se izvaja z uporabo ukaza [http://opencascade.sourcearchive.com/documentation/6.3.0.dfsg.1/classBRepAlgoAPI__Cut.html BRepAlgoAPI__Cut], kjer dodamo kot argumente 3D obliki. Prvi argument predstavlja osnovno obliko, drugi argument pa predstavlja geometrijo, ki jo odštevamo. Vrstni red je v tem primeru pomemben!
{{{
#!python
odstevanje = BRepAlgoAPI_Cut(Objekt1, Objekt2)
}}}
[[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]]


== Geometrijske transformacije ==
Translacija objekta (Transform) [[Image(23.png, right)]] [[BR]][[BR]]
Za premik objekta v prostoru se uporabi funkcija za translacijo. Pri tem je potrebno najprej določiti vektor premika, nato pa izberemo obliko, ki jo želimo premakniti v prostoru. Preprosta koda je zapisana:
{{{
#!python
Premik = gp_Vec(U_X, U_Y, U_Z)
Translacija = gp_Trsf()
Translacija.SetTranslation(Premik)
rezultat = BRepBuilderAPI_Transform(Oblika, Translacija).Shape()
}}}
[[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]]


Rotacija objekta (Rotation) [[Image(24.png, right)]]  [[BR]][[BR]]
V kolikor želimo obstoječi objekt rotirati, je potrebno določiti najprej referenčno točko, ki služi kot lokacija osi vrtenja, ter nato določiti še rotacijsko os s smerjo vektorja. Potrebno je tudi določiti kot rotacije, ki ga določimo v radianih. Nazadnje izberemeo obliko, ki jo hočemo zavrteti okoli izbrane osi. Preprosti algoritem je zapisan:
{{{
#!python
LokacijaOsi = gp_Pnt(U_X, U_Y, U_Z)
RotacijaOs = gp_Ax1(LokacijaOsi, gp_Dir(Smer_X,Smer_Y,Smer_Z))
TransfRot = gp_Trsf()
TransfRot.SetRotation(RotacijaOs, Kot_radiani)
rezultat = BRepBuilderAPI_Transform(Oblika, TransfRot).Shape()
}}}
[[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]]


Povečava objekta (Scale) [[Image(24a.png, right)]]  [[BR]][[BR]]
Objektu lahko spremmenimo  velikost tudi po tem, ko je le ta enkrat že narejen. To napravimo z uporabo orodja za povečavo. Pri tem rabimo določiti referenčno točko za izvajanje geometrijske operacije ter merilo (povečavo objekta). Nazadnje izberemeo obliko, ki ji hočemo spremeniti merilo. Preprosti algoritem je zapisan:
{{{
#!python
Tocka = gp_Pnt(0 , 0 , 0)
Povecava = gp_Trsf()
Povecava.SetScale(Tocka,merilo)
rezultat = BRepBuilderAPI_Transform(Oblika Povecava).Shape()
}}}
[[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]]


== Aplicirane značilke ==
Podobno kot pri komercialno dostopnih modelirnikih, lahko obstoječo geometrijo naknadno preoblikujemo z uporabo apliciranih značilk. Glavna lastnost apliciranih značilk je, da ne morejo obstajati kot samostojni predmet, ampak rabijo neko predhodno zmodelirano 3D geometrijo, ki jo nato spremenimo. Poznamo mnogo različnih apliciranih značilk. Nekatere izmed njih bomo razložili v tem poglavju.
[[BR]][[BR]]

=== Izdelava zaokrožitev (Fillet) ===
Poznamo dve vrsti zaokrožitve; zaokrožitev s konstantnim radiem zaokrožitve ter zaokrožitev s sprejemljivim radiem zaokrožitve.
Knjižnica ukazov za izdelavo zaokrožitev se nahaja v viru BRepFilletAPI in jo je potrebno vključiti v program pred uporabo ukaza:
{{{
#!python
from OCC.TopExp import*        
from OCC.BRepFilletAPI import * 
from OCC.Utils.Topology import *
}}}
Pri apliciranju vseh vrst zaokrožitev je potrebno imeti podatek o robu oziroma točki kamor hočemo izvesti zaokrožitev ter o parametrih zaokrožitve (radij zaokrožitve).

==== Zaokrožitev s konstantnim radiem zaokrožitve ====
Prvi korak je izbira objekta, na katerem se izvede zaokrožitev: [[Image(25.png, right)]]
{{{
#!python
zaokrozitev = BRepFilletAPI_MakeFillet(Oblika)
}}}
Sledi izbira robov ter parametrov zaokrožitve. Primer, ko izvedemo zaokrožitev na vseh robovih elementa:
{{{
#!python
topology_traverser = Topo(Oblika)
for aEdge in topology_traverser.edges():
    zaokrozitev.Add(Radij , aEdge)
#    zaokrozitev.Add(Radij_1, Radij_2 , aEdge)
}}}
[[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]] [[Image(26.png, right)]]
Za izbiro točno določenih robov, na katerih hočemo izvesti zakrožitve, je potrebno vpeljati različne geometrijske teste. Primer, ko hočemo zakrožiti zgolj vertikalne robove kocke. Vpeljemo preprosti test, ki nam pove, če točki robova ležita na isti ravnini (X,Y). 
{{{
#!python
for aEdge in topology_traverser.edges():
    first, last = TopExp().FirstVertex(aEdge), TopExp().LastVertex(aEdge)
    first_vert, last_vert = BRep_Tool().Pnt(first), BRep_Tool().Pnt(last)
    if first_vert.Z() != last_vert.Z():
        zaokrozitev.Add(Radij, aEdge)
}}}
Pri izdelavi zaokrožitev moramo biti pozorni na velikost zaokrožitve. Vrednost zaokrožitve mora biti dovolj majhna da lahko normalno zaokrožimo robove.
[[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]]


==== Zaokrožitev z variabilnim radiem zaokrožitve ==== 
[[Image(27.png, right)]]
Za apliciranje variabilnega radija zaokrožitve na modelu je potrebno razdeliti izbrani rob na intervale ter nato določiti radij zaokrožitve na določenem intervalu. Primer razdelitve robu na 6 intervalov ter določitev parametrov:
{{{
#!python
TabPoint = TColgp_Array1OfPnt2d(1,6)
P1 = gp_Pnt2d(0.,8.)
P2 = gp_Pnt2d(0.2,16.)
P3 = gp_Pnt2d(0.4,25.)
P4 = gp_Pnt2d(0.6,55.)
P5 = gp_Pnt2d(0.8,28.)
P6 = gp_Pnt2d(1.,20.)
TabPoint.SetValue(1,P1)
TabPoint.SetValue(2,P2)
TabPoint.SetValue(3,P3)
TabPoint.SetValue(4,P4)
TabPoint.SetValue(5,P5)
TabPoint.SetValue(6,P6)
}}}
Določitev izbranega robu na katerem izvedemo ukaz poteka:
{{{
#!python
exp = TopExp_Explorer(Oblika,TopAbs_EDGE)
exp.Next()
exp.Next()
exp.Next()
exp.Next()
}}}


==== Zaokrožitev okoli točke ====
[[Image(28.png, right)]]
Zaokrožitev lahko izvedemo tudi okoli točke. V tem primeru je potrebno najprej izbrati točko, okoli katere hočemo izvesti zaokrožitev. Nato določimo vse robove, ki imajo začetno ali končno vozlišče v izbrani točki, ter izvedemo zaokrožitev na teh robovih. To lahko naredimo z uvedbo nove funkcije:
{{{
#!python
def vertex_fillet(oblika, tocka):
    afillet = BRepFilletAPI_MakeFillet(oblika)
    cnt = 0
    for edg in topo.edges_from_vertex(tocka):
        first, last = TopExp().FirstVertex(edg), TopExp().LastVertex(edg)
        vertex, first_vert, last_vert = BRep_Tool().Pnt(tocka), BRep_Tool().Pnt(first), BRep_Tool().Pnt(last)
        if edg.Orientation():
            if not vertex.IsEqual(first_vert, 0.001):
                afillet.Add(Radij_1, Radij_2, Rob)
            else:
                afillet.Add(Radij_1, Radij_2, Rob)
            cnt+=1
    afillet.Build()
    if afillet.IsDone():
        return afillet.Shape()

#izvedba zaokrozitve okoli tocke
zaokrozitev_tocka = vertex_fillet(oblika,tocka1)
}}}
[[BR]][[BR]][[BR]][[BR]][[BR]][[BR]][[BR]]


=== Izdelava posnetij (Chamfer) ===
Pri izdelavi posnetij v programskem okolju je potrebno predhodno uvesti knjižnico orodij za izdelavo posnetij:
{{{
#!python
from OCC.TopExp import* #knjiznica z topoloskimi elementi
from OCC.BRepFilletAPI import * #Knjiznica z zaokrozitvami
from OCC.Utils.Topology import *
from OCC.BRep import *
}}}
Izdelava posnetja poteka podobno, kakor izdelava zaokrožitve, saj imamo za vir ukazov isto knjižnico BRepFilletAPI. Na enak način, kot v primeru zaokrožitve, določimo uporabo posnetja:
{{{
#!python
posnetje = BRepFilletAPI_MakeChamfer(kocka.Shape())
}}}
Operacija za izdelavo posnetja pa zahteva nekoliko več argumentov, saj je lokacija posnetja določena z izbiro robu ter referenčne površine. Pri določitvi velikosti posnetja imamo lahko primer posnetja pod kotom 45°, za kar rabimo določiti samo eno razdaljo posnetja, ali pa primer ko imamo kot posnetja različen od 45°. V tem primeru je potrebno določiti razdalji posnetja na površinah, ki obdajata rob. Dodajanje posnetja na obliko poteka:
{{{
#!python
posnetje.Add(Razdalja, Rob, Povrsina)
posnetje.Add(Razdalja_1, Razdalja_2, Rob, Povrsina)
}}}
Primer izdelave posnetja na zgornji in spodnji ploskvi kocke:
{{{
#!python
posnetje = BRepFilletAPI_MakeChamfer(Oblika)
topology_traverser = Topo(Oblika)
for aEdge in topology_traverser.edges():
    first, last = TopExp().FirstVertex(aEdge), TopExp().LastVertex(aEdge)
    first_vert, last_vert = BRep_Tool().Pnt(first), BRep_Tool().Pnt(last)
    if first_vert.Z()==Visina and last_vert.Z()==Visina:
        for aFace in topology_traverser.faces():
                posnetje.Add(Razdalja, Rob, Povrsina)
#                posnetje.Add(Razdalja_1, Razdalja_2, Rob, Povrsina)
    if first_vert.Z()==0 and last_vert.Z()==0:
        for aFace in topology_traverser.faces():
                posnetje.Add(Razdalja, Rob, Povrsina)
#                posnetje.Add(Razdalja_1, Razdalja_2, Rob, Povrsina)
kocka = posnetje
}}}

=== Izdelava lupine ( Shell ) ===
Volumski model lahko pretvorimo tudi v tenkostenski objekt z orodjem za izdelavo lupin. Pri tem uporabimo nabor ukazov iz knjižnice BRepOffsetAPI:
{{{
#!python
from OCC.BRepOffsetAPI import *
}}}
Pri izdelavi lupine je potrebno določiti geometrijo iz katere hočemo narediti lupiono, ploskve, ki jih hočemo odstraniti, debelino lupine ter toleranco izdelave modela:
{{{
#!python
lupina = BRepOffsetAPI_MakeThickSolid(Oblika, Odstr_ploskve, debelina, toleranca)
}}}

=== Izdelava odmika ( OffsetShape ) ===
Z orodjem za izdelavo odmika lahko napravimo nov objekt, ki bazira na obstoječi geometriji, le da je nekoliko večji ali pa manjši. Za uporabo ukaza je potrebno v program uvesti knjižnico:
{{{
#!python
from OCC.BRepOffsetAPI import *
}}}
Napravimo vzporedni odmik posamezne ploskve ali pa vzamemo kar celotni objekt. Najbolj preprosta operacija zahteva argumente geometrije, dolžine vzporednega odmika ter tolerace. Vzporedni odmik lahko poteka v obe smeri- lahko naredimo element, ki je večji ali manjši od osnovnega modela. 
{{{
#!python
odmik = BRepOffsetAPI_MakeOffsetShape(Oblika,debelina,toleranca)
odmik = BRepOffsetAPI_MakeOffsetShape(Oblika,debelina,toleranca, BRepOffset_Skin, Standard_False, Standard_False, GeomAbs_Intersection)
}}}
=== Izdelava kota nagiba ( Draft_Angle ) ===

=== Izdelava rebra ( MakeLinerForm ) ===