phantom technology | software | algorithms | game...

26

Upload: others

Post on 18-Aug-2020

0 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

Software user manual Author / ownerCompanySoftware versionPublication dateCopyright

Guus ThissenPhantom Technology1.4.218-9-2016©2015-2016

3 D P E R S P E C T I V E M A T C H I N G T E C H N O L O G Y

Phantom Photo Match

Page 2: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

Table of contents

1 of 25

01

02

03

IntroductionAn introduction to Phantom Photo Match.

Page 6

SupportInformation about system requirements, OBJ model support andtroubleshooting.

Page 7

LicensingInformation about obtaining a license, the End-User License Agreement(EULA) and activating the Phantom Photo Match software.

Page 8-10

SetupShort tutorial on the Phantom Photo Match setup.

Page 11

Page 3: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

Table of contents

2 of 25

04Gettings startedInformation about the panels in the GUI and the individual functions.

Page 11

05

07

Graphical user interface (GUI)Information about the panels in the GUI and the individual functions.

Page 12

06Functions

Information about the available functions.

Page 13-14

Perspective setupDragging the red/green nodes to determine the perspective.

Page 15

Page 4: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

Table of contents

3 of 25

Reference meshImporting a OBJ reference mesh to match up to the photo.

Page 1608

Scene scaleAccurately scaling the scene to fit correctly in the photo.

Page 1709

Getting the data into OctaneRenderCopying over the exact camera properties.

Page 17

10

11 Save/loadSaving or loading your setup.

Page 18

Page 5: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

Table of contents

4 of 25

12Octane setupSetting up the scene in Octane (includes example file).

Page 18

Exporting into other toolsTutorial on how to get the camera perspective data into other tools.

Page 19-20

Software changelogA list that contains the changes to the software, seperated per major update.

Page 21-22

13

Final wordA word about the software in general and the development team.

Page 23

14

Page 6: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

5 of 25

Page 7: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

6 of 25

Introduction

I f you work in architectural visualization, chancesare you will work in projects where existingarchitecture will be modified or expanded.

Octane Render can be very useful for this. I t canimport a reference photo in the background,allow you to set that transparent, and render a 3Dscene.

However, Octane Render itself falls short whenyou want to create seamless intergrationbetween photo and 3D. That is where PhantomPhoto Match comes into play. Instead of cluelessguessing of what the various camera propertiesshould be (and never getting it right), PhantomPhoto Match can calculate this for you, based onthe axis lines that you place on geometry in yourphoto. The camera data can then be entered inOctane Render standalone to create a 3Dperspective that matches your photo.

Guus ThissenPhantom Photo Match lead developer

Page 8: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

7 of 25

01 | SupportSystem requirements

Phantom Photo Match has the following systemrequirements:

• The software is designed for the MicrosoftWindows platform. I t's tested and workingon Windows Vista, Windows 7, Windows 8and Windows 8.1. I t will probably also runon Windows XP should you want to.

• An active internet connection is requiredso the software can validate yourregistration. This only happens when theprogram is launched.

• The software is designed to cooperatewith Octane Render. This software isobviously required to make usage ofPhantom Photo Match. I t might bepossible to use the same camera data inother rendering tools aswell.

OBJ model support

OBJ models should work flawlessly as long asthe faces that make up the model are triangles (3vertices/face) and/or quads (4 vertices/face).Faces with 5 vertices or more are not supported.If your OBJ models have 5 vertices or more, trytriangulating them.

I am trying to deliver broad OBJ support. If yourmodeling package creates OBJs that are notcompatible, please contact me. Users havetested and tried with the following modelingpackages:

ArchiCAD, Blender, SketchUp, Rhino, Maya,Lightwave, DAZ, Artlantis, 3DS Max, Revit,Softimage and ZBrush.

Troubleshooting

Should you run into any problems, pleasecontact me at [email protected].

• A problem in the ArchiCAD OBJ exportercan cause it to export incorrect normals inthe OBJ. When this happens, tryexporting your model into GoogleSketchUp first. Then export it as OBJusing TIG’s plugin.

• In case of a DirectX compile error, you areprobably missing the DirectX9.0c runtime.This will install alongside any existingversions of DirectX you might havealready:

link:http://www.microsoft.com/en-gb/download/details.aspx?id=35

• In case you get an error about missingMSVCP120.dll, that is because you need anewer visual C++ runtime. Select theoption vcredist_x86.exe, regardless if yourmachine is 32-bit or 64-bit.

link:http://www.microsoft.com/en-us/download/details.aspx?id=40784

• I 've received a report where the softwaredid not get data loading/writingpermissions from Windows. I suspectMicrosoft UAC (User Account Control) wasblocking it. I recommend to run thesoftware as administrator when thishappens, that should solve it.

Page 9: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

8 of 25

02 | LicensingObtaining a license

A license is valid for a single PC. Once you'veactivated the software, the software will belocked to that PC. As long as you have a validlicense, you will always get the latest version ofthe software.

To request a license, please contact me at thefollowing e-mail address:

[email protected]

You will be given a link to PayPal, where you canmake the transaction. As soon as I see thetransaction has been completed, I will send youa reply to your e-mail with your personalusername, registration key and download link tothe software.

By downloading and/or using the software, youagree to the End-User License Agreement(EULA). The EULA can be read on the next twopages of this manual.

Should you upgrade your PC, then you cancontact me for a new license key. Your old keywill be deactivated.

Please check the system requirements beforebuying.

Activating the Phantom PhotoMatch software

When first running the Phantom Photo Matchsoftware, you will be asked to enter yourusername. This will be the e-mail address yourequested the license with, unless I specificallygive you another username (this can berequested).

Enter your username and press OK.

A new window pops up, requesting yourregistration key.

Enter your registration key (I recommend copy-pasting it) and press OK.

The software should now be registered andready for use!

Page 10: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

9 of 25

End-User License Agreement (EULA)

Please read the following terms and conditions carefully before using this SOFTWARE PRODUCT. Your use,

distribution or installation of this copy of "PHANTOM PHOTO MATCH" indicates your acceptance of this License.

SOFTWARE PRODUCT here means Software, image files, all accompanying files, data and materials received

with your order of "PHANTOM PHOTO MATCH".

If you do not agree to any of the terms of this License, then do not install or use the SOFTWARE PRODUCT. If you

have purchased a single copy from GUUS THISSEN, you may return it within thirty (30) days after purchase, for a

refund of your payment less any incidental charges. The 30-day warrantee is applicable only to products bought

within YOUR COUNTRY. Products downloaded to or shipped out of YOUR COUNTRY are strictly non-refundable.

Warrantee covers defects in the software, which prevents successfully installing the software in the buyer's PC.

Warrantee does not cover fitness of purpose, not meeting of expectations or needs in the mind of the buyer.

This SOFTWARE PRODUCT is for personal use only and may be installed and used by on only one computer. I ts

component parts may not be separated for use on more than one computer. All components accompanying the

software are copyrighted by GUUS THISSEN and may not be taken apart, modified, used or published with other

software or means except with the SOFTWARE PRODUCT software and may not be distributed or copied in any

manner.

This SOFTWARE PRODUCT, all accompanying files, data and materials, are distributed "AS IS" and with no

warranties of any kind, whether express or implied. The user must assume all risk of using the program. This

disclaimer of warranty constitutes an essential part of the agreement.

Any liability of GUUS THISSEN will be limited exclusively to refund of purchase price. In addition, in no event shall

GUUS THISSEN, or his principals, shareholders, officers, employees, affiliates, contractors, subsidiaries, or parent

organizations, be liable for any incidental, consequential, punitive or any other damages whatsoever relating to

the use of SOFTWARE PRODUCT.

In addition, in no event does GUUS THISSEN authorize you to use this SOFTWARE PRODUCT in applications or

systems where SOFTWARE PRODUCT's failure to perform can reasonably be expected to result in a physical

injury, or in loss of life. Any such use by you is entirely at your own risk, and you agree to hold GUUS THISSEN

harmless from any claims or losses relating to such unauthorized use.

This Agreement constitutes the entire statement of the Agreement between the parties on the subject matter,

and merges and supersedes all other or prior understandings, purchase orders, agreements and arrangements.

This Agreement shall be governed by the laws of THE NETHERLANDS.

Page 11: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

10 of 25

GUUS THISSEN, the owner of the copyright of this SOFTWARE PRODUCT, all of its derivatives, title and

accompanying materials are the exclusive property of GUUS THISSEN. All rights of any kind, which are not

expressly granted in this License, are entirely and exclusively reserved to and by GUUS THISSEN. You may not

rent, lease, transfer, modify, translate, reverse engineer, de-compile, disassemble or create derivative works

based on this SOFTWARE PRODUCT. You may not make access to SOFTWARE PRODUCT available to others in

connection with a service bureau, application service provider, or similar business. There are no third party

beneficiaries of any promises, obligations or representations made by GUUS THISSEN herein.

You may not disclose to other persons the data or techniques relating to this SOFTWARE PRODUCT that you

know or should know that it is a trade secret of GUUS THISSEN in any manner that will cause damage to GUUS

THISSEN.

This SOFTWARE PRODUCT and all services provided may be used for lawful purposes only. Transmission,

storage, or presentation of any information, data or material in violation of any YOUR COUNTRY, State or City law

is strictly prohibited. This includes, but is not limited to: copyrighted material, material we judge to be threatening

or obscene, or material protected by trade secret and other statute. You agree to indemnify and hold GUUS

THISSEN harmless from any claims resulting from the use of this SOFTWARE PRODUCT, which may damage any

other party.

I f you own a LIFETIME LICENSE, this means that you are able to use the software for as long as thisSOFTWARE PRODUCT is available for licensing. If this SOFTWARE PRODUCT is no longer hostable dueto financial problems, this SOFTWARE PRODUCT will be stripped from it's DRM and made available toyou.

Page 12: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

11 of 25

03 | SetupThere is no mandatory setup required when youlaunch the program.

The program will automatically create the folderC:/Phantom Photo Match on your C: drive.

I t will also create a file called ppm.settings in saidfolder. This file stores the options set in PhantomPhoto Match. There is no need to edit it yourself.

I t would be a good idea to store the files that youdownloaded in the ZIP in this folder, so theywon't get lost. But that is not requirement, youcan put them somewhere else if you wish. I twould also be a good idea to download thismanual and store it in that folder aswell.

If you need help or have feature suggestions, e-mail me at [email protected].

You can also post in the topic here:http://render.otoy.com/forum/viewtopic.php?f=9&t=48403

figure 04.1 (image taken in 1.2)

04 | Getting startedWhen you start up the program, you will bepresented with the screen shown in figure 04.1.

The screen will be divided up into 2 sections: themain view (which says: 'SELECT IMPORT IMAGETO GET STARTED') and the bottom part with thesoftware's function buttons, which are sorted intodifferent modules. As soon as you've imported aphoto, the main view will change accordingly.

Let's do this now.

Go to IMPORT / EXPORT › IMPORT IMAGE andbrowse to tutorial_backyard.jpg, for the sake ofthe tutorial. I t's among the tutorial files.

When importing photos, it is important to knowthat not all types of compression are supportedby the image importer. So if your particular *.JPGfile is rejected, try saving it as a *.PNG instead andtry to import it. Incase it is rejected, the programwill crash. Nothing to worry about, just relaunch itand try another image.

Page 13: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

12 of 25

05 | Graphical user interface (GUI)

Your window should now look like figure 05.1.

(1) Image with 3D preview

This essentially your photo workspace. On top ofthe image are perspective line indicators, anorigin indicator and a 1x1x1m transparent cube.

(2) Final results of algorithm

These variables show the final results of theperspective calculation algorithm. These valuesare updated in realtime when you make edits.

(3) High-precision scene scaletool

This tools allows you to scale your OBJ scenevery precisely so it matches up in your photo.

Controls

• To move around your image (1), simplyclick and hold the right mouse button inthe main view and drag the mouse.

• Use the mousewheel to zoom in and out.You can also use the page up/page downkeys to do this.

figure 05.1 (image taken in 1.2)

1 2

• Use the left mouse button to click andhold to drag the axis nodes (the red andgreen dots) or the origin point to movethem around.

• Use the left mouse button to click on anyof the final result variables in the top-rightcorner of the GUI (2). The value of thatparticular variable will then be copiedover to the clipboard. The variable canthen be pasted (CTRL+V) inside OctaneRender standalone in the camera'ssettings. The value copied to theclipboard has a much higher precisionthan the one displayed in the GUI .

• Use the left mouse button to clickon any of the upwards or downwardspointing arrows of the scene scale tool (3).Use these to finetune your scene's scalein the photo with a high degree ofprecision.

• Use the left mouse button to access anyof the function buttons in the lower half ofthe screen.

3

Page 14: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

13 of 25

MAIN

TOOL (Previously called RENDERED)This function changes the buttons in the top-right of the GUI to accommodate the render toolyou are using.

ANTI ALIASINGDetermines the use of anti-aliasing in the 3Dview. Makes 3D geometry very smooth to look at.Performance will take a hit.

VERTICAL SYNCDetermines the use of vertical synchronisation.GPUs do not run at the same speed as monitors.Enabling this makes the GPU wait for the nextmonitor update. Prevents screen tearing.Performance will take a hit.

WIREFRAMEDisplays the wireframe of the imported OBJ,which helps to identify the OBJ structure. I highlyrecommend putting ANTI ALIASING on 4X whenthis feature is set to ON.

INTERPOLATE IMAGEWhen zooming in on a photo, the quality willdegrade very fast and will become very pixely. Byturning on this function the image will besmoothed. Useful when placing down nodes.

TRANSPARENCYDetermines the transparency of the *.OBJreference mesh. Useful when trying to match itup to the photo.

UI BACKGROUNDThis function allows you to choose from 3background UI options that affect the graphics ofthe modules. The options NONE, PARTLY andSOLID.

IMPORT / EXPORT

IMPORT IMAGEImports a reference photo. Not that not all typesof compression ar supported. So for example ifyour particular *.JPG photo is rejected, tryconverting it to *.PNG (using GIMP or Photoshopand try again).

IMPORT SCALEDetermines the factor that scales an *.OBJ whenit is imported in Phantom Scatter. Being a factor,it means a value of 1 means the *.OBJ would beimported at 100 % of its size. A factor of 0.001means the *.OBJ is imported at 0.1 % of its size.

Important: Phantom Scatter is designed towork with meters. That means 1

unit equals 1 meter.

IMPORT OBJThis allows you to browse to your *.OBJ file ofchoice and import it.

EXPORT SCALEThis scale influences the export values that arecopied to the clipboard. Possible export scalesare millimeters (MM), centimeters (CM),decimeters (DM) and meters (M). Octane Renderstandalone works in meters by default.

EXPORT OCT CAMERAWhen pressing this button, Phantom PhotoMatch will put XML code in your clipboard. Youcan then use CTRL+V in the Graph Editor inOctane Render standalone and a camera nodewill be created with the correct data. You canthen rig this camera node up to a render targetnode.

EXPORT OCT RESOLUTIONWhen pressing this button, Phantom PhotoMatch will put XML code in your clipboard. Youcan then use CTRL+V in the Graph Editor inOctane Render standalone and an imageresolution node will be created with the correctdata. You can then rig this image resolution nodeup to a render target node.

EXPORT ENVIRONMENT MAPExport the current environment map image as a*.PNG file.

SETUP

LOADS SETUPLoads a previously defined setup.

06 | Functions

Page 15: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

14 of 25

SAVE SETUPSaves the current setup. The following propertieswill be saved:

• Locations of the red/green axis nodesthat determine the perspective

• Location of the origin node• Scene rotation• Scene scale• Color indicators• Environment map• Scene offset

SCENE ROTATIONAngle that corrects the rotation of the scene.Common values are 0°, 90°, 180° and 270°. At 360°it comes at full circle, in other words 0° is thesame as 360°.

SCENE ROTATIONAngle that corrects the rotation of the scene.

SCENE ORIGIN OFFSETAllows you to fly around the imported *.OBJmodel in 3D space. You can then pinpoint alocation with the left mouse button to determinethe position that should be used for the ORIGINnode inside the interface. I t makes dealing withmodels that are far away from the absolute origin(0,0,0) a lot easier. No need to change yourmodel inside the render tool, the offset is takeninto account in the exported data automatically.

RESET AXIS LINESResets the red/green nodes.

RESET ORIGINResets the origin node.

RESET OFFSETResets the offset, meaning the ORIGIN node inthe interface will be at position (0,0,0) in yourscene again.

INTERFACE

RESET VIEWReset the view.

RESET MODEL TO DEFAULTReverts to the default cube models instead ofshowing the model you imported.

ENVIRONMENT MAP

CURRENT INDEXControls the currently active color. You can alsoclick inside the little boxes next to the colors inthe GUI to achieve the same effect.

SAMPLE ON SHEETThis function pops up a color sheet andgrayscale sheet, allowing you to change thecurrently active color.

SAMPLE ON IMAGEThis function lets you change the currently activecolor to the color of a pixel you pinpoint on theimported image.

SAMPLE ON IMAGE (BLUR)Same as function SAMPLE ON IMAGE, but thistime Phantom Photo Match temporarily blurs theimported image. That way you can get theaverage color tint of regions in your image, whichis more suitable for drawing on the environmentmap.

PAINT ENVIRONMENT MAPThis function allows you to paint on theenvironment map, located below the importedimage in the GUI . Use the left mouse button topaint where you want. When painting on the leftor right edge on the screen, a clone brush willappear on the other side. That way theenvironment map will be perfectly seamless allthe way around. While the tool is activated, youcan use SHIFT+MOUSEWHEEL to change thebrush radius. You can also useCTRL+MOUSEWHEEL to change the paintingintensity. The environment map will be savedinside your setup, so you don't have to be afraidof losing it.

Page 16: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

15 of 25

Now it's time to setup the perspective. I t isimportant that you have good reference points inyour photo. You will want the angle between thered-node lines and green-node lines to amountfor a difference of 90° in real life. That wayPhantom Photo Match will be able to work outthe vanish points and work everything out fromthere.

figure 07.2

figure 07.1

Zoom in and out to accurately place down thenodes. This is essential if you want good results.The controls are described in the previouschapter of this manual. When you're happy,continue to the next chapter of this manual. Don'tworry, you can always change the nodeswhenever you want. In most cases you'll want tofinetune it later.

07 | Perspective setup

Page 17: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

16 of 25

08 | Reference meshThe next step is to import a reference mesh.Simply go to IMPORT / EXPORT › IMPORT OBJand for the sake of this tutorial, browse totutorial_bulborb.obj . (copyright Nintendo)Importing an *.OBJ means the wireframe cubewill be replaced by your own mesh, displayedwith solid triangles.

If you wish to adjust the transparency ofimported OBJ meshes, go to MAIN › OBJ MESHTRANSPARENCY and pick a value you like. This isa global setting so it will carry through when yourestart the program.

If you set it up like I did, you will see that thecamera is oriented in a way that you are lookingto the right side of the imported *.OBJ mesh. Let'scorrect it so the camera is oriented as if Bulborbis looking towards the front of the photo. Go toSETUP › SCENE ROTATION and enter a value of270 (degrees). As you can see, this function isused to make sure the camera is looking at your*.OBJ mesh from the right angle. Common valuesare 0°, 90°, 180° and 270°. At 360° the rotation willhave come full circle, in other words 360° is thesame as 0°.

figure 08.1

Drag the origin node around to place the meshorigin where you want it to be. The view willrefresh when you let go of the node.

Zoom in and out to be able to precisely positionthe mesh.

The mesh is rendered at the same resolution asthe photo you imported.

Page 18: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

17 of 25

Next up is accurately scaling the scene in orderto fit the photo. To make this process intuitive, Imade a special tool for it in the right-bottomcorner of the screen. Then you can tweak itintuively as well as accurately.

You can click any of the arrows to edit the scenescale variable.

Essentially this is the scaling factor from the*.OBJ mesh to the position of the camera. Whatthis means is that if the scene scaling factorincreases, the camera will be placed furtheraway from the *.OBJ mesh, which means the*.OBJ mesh will be displayed smaller inside yourphoto.

For the sake of the tutorial, set the scene scale toa value of 3.25. The value of 3.25 is smaller thanthe default value of 5, which means the *.OBJmesh will be displayed bigger inside the photo.

For some reason, Octane uses a horizontal FOV,instead of a vertical FOV which is common inalmost all 3D applications. Be careful not to mixthem up.

9 | Scene scale

10 | Getting the datainto Octane RenderTo get the correct camera data into OctaneRender (standalone), I 've created a display ofvariables in the top-right corner of the screen.

When you click on one of these variables, thevalue will be copied to your clipboard (with ahigh decimal precision). You can then paste thevalue into the Octane camera's properties. Thereis no support in Octane to load cameraproperties from a file, so this will have to do. Goback an forth between Phantom Photo Matchand Octane to copy over all 10 relevant variables.I t helps if you briefly put the programs alongsideeach other.

These are the relevant variables:

• FIELD OF VIEW• POSITION X• POSITION Y• POSITION Z• TARGET X• TARGET Y• TARGET Z• UP-VECTOR X• UP-VECTOR Y• UP-VECTOR Z

figure 10.1

Attention! In Phantom Photo Match 1.1, newfunctionality has come to make this process alot easier.

You can now go to IMPORT / EXPORT › EXPORTOCT CAMERA and special XML data will beplaced onto your clipboard. All you have to donow is go to Octane Render standalone's grapheditor and press CTRL+V. A camera node will becreated for you with the correct data!

You can also go to IMPORT / EXPORT › EXPORTOCT RESOLUTION to retrieve XML data on yourclipboard that can create an Image resolutionnode with your photo's resolution inside OctaneRender's graph editor, for your convenience.

Page 19: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

18 of 25

Now the camera data is inside Octane, it wouldbe a good idea to save your setup. Go to SETUP ›SAVE SETUP and choose a good name. This willcreate a *.PPMD file that can be loaded later onincase you want to edit the perspective.

The following properties will be saved:

• Locations of the red/green axis nodesthat determine the perspective

• Location of the origin node

• Scene rotation

• Scene scale

The imported photo and *.OBJ mesh will not besaved. So when the locations of those fileschange, or break completely, that means you willstill be able to load in the data. I t's a safetyprecaution.

Kernel

In the rendering kernel, you should enable theproperty alpha channel. What this does is renderyour image as you would expect it to, except thesky. The sky will be a bunch of pixels with atransparency of 100%, which means the imagewill be suitable to overlay on your photo. Seefigure 10.2.

Photo background

In Octane Render it's possible to diplay yourphoto as the background image. See figure 10.1.When doing so, the image is going to scalealong with your viewport, but it does not take theaspect ratio into account. So be sure to manuallyset the correct resolution of the render.Personally I set the rendering resolution to theexact same as the resolution as the photo.

When exporting your render, Octane does notbake the photo image into the render. You willhave to do this manually in a tool like GIMP orPhotoshop. Simply open up your photo, and thenput the exported render on top of it in a newlayer.

figure 12.1

figure 12.2

Shadow catcher

Open up tutorial_octane.ocs in Octane. In thisfile you will see how the modelstutorial_bulborb.obj and tutorial_plane.obj arecombined using a Geometry Group. In this sceneI 'm using tutorial_plane.obj (which is scaled upusing a Placement node) to catch the shadowscoming from tutorial_bulborb.obj . The plane hasa special material: a shadow catcher. I t's basicallyan invisible material that can catch (or cast)shadows from (or in) the scene. Use it to makeyour 3D objects cast shadows onto the surfacesin the photo, or create geometry in the scenethat will cast shadow onto your 3D objects.

The shadow catcher material is included intutorial_octane.ocs. I t's a diffuse material with asolid black diffuse color. I t has matte enabled. Igave it an opacity value of 0.85, to make itsomewhat fit the shadows in the photo. If you areusing a shadow catcher material in your ownproject, you should play around with this value totweak the shadow intensity.

11 | Save/load

12 | Octane setup

Page 20: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

19 of 25

Octane Render for Rhinoceros 3D

Go to MAIN › TOOL and choose RHINOCEROS.The buttons in the top-right corner of the GUIshould now have changed. Enter the data inRhinoceros in the following variables:

13 | Exporting into other tools

figure 13.1

Octane Render for Revit

To get the data in Revit, go to IMPORT / EXPORT› EXPORT OCT CAMERA.

You can paste that data into the Octane for Revitplugin using a special function. Please contactthe Octane for Revit developer to learn more.

Page 21: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

20 of 25

Blender andOctane Render for Blender

Go to MAIN › TOOL and choose BLENDER.The buttons in the top-right corner of the GUIshould now have changed to accomodate theBlender camera.

To start from a clean slate, go to Blender and addin a new camera. In the main 3D view, press the Nkey to make the menu on the right side of it popup. The 'Transform' section is what we need.

Go back to Phantom Photo Match and click thevalue that belongs to POSITION X in the top-rightcorner of the GUI . This value is now copied to theclipboard. Go back to Blender and click in the 'X: 'field under 'Location' in the 'Transform' section.Then press CTRL+V to enter the value and hit theEnter key. Do the same for Y and Z. The positionshould now be set up correctly.

The next step is to determine the orientation ofthe camera. Under 'Rotation', set the camera touse 'Quaternion (WXYZ)'. Now go back toPhantom Photo Match and start entering thecorrect variables for W, X, Y and Z. Again, this canbe done easily by clicking inside the PhantomPhoto Match interface to quickly get the valuesonto your clipboard.

Now go to the 'Camera' tab in Blender (Not the'Render' tab! ). Under the section 'Camera', set theSensor to 36.

Now go to the 'Lens' section and turn the setting'Millimeters' into 'Field of View'. Now go toPhantom Photo Match to get the final variable,the field of view. Paste it into the 'Field of View'setting in Blender.

All done!

figure 13.2

Page 22: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

21 of 25

14 | Software changelogPhantom Photo Match 1.1

• Interface refinement to establish acoherent and understandable functionsetup between various PhantomTechnology software products.There are now interface 4 modules:MAIN, IMPORT/EXPORT, SETUPand INTERFACE.

• Added the feature EXPORT SCALE, foundin the IMPORT/EXPORT menu module.This scale influences the export valuesthat are copied to the clipboard. Possibleexport scales are millimeters (MM),centimeters (CM), decimeters (DM) andmeters (M). Octane Render standaloneworks in meters by default.

• Added feature EXPORT OCT CAMERA,found in the IMPORT/EXPORT menumodule. When pressing this button,Phantom Photo Match will put XML codein your clipboard. You can then useCTRL+V in the Graph Editor in OctaneRender standalone and a camera nodewill be created with the correct data.You can then rig this camera node up to arender target node.

• Added feature EXPORT OCTRESOLUTION, found in theIMPORT/EXPORT menu module. Whenpressing this button, Phantom PhotoMatch will put XML code in yourclipboard. You can then use CTRL+V inthe Graph Editor in Octane Renderstandalone and an image resolution nodewill be created with the correct data.You can then rig this image resolutionnode up to a render target node.

Phantom Photo Match 1.2

• Added function UI BACKGROUND underthe MAIN module. This function allowsyou to choose from 3 background UIoptions that affect the graphics of themodules. The options NONE, PARTLY andSOLID.

• Improved curve quality of the GUI .

• Software icon has a transparentbackground now instead of the grayblock.

• Renamed the function RENDERER toTOOL. The options have beenrenamed aswell. They are now:OCTANE RENDER and RHINOCEROS.

• Added option BLENDER to functionRENDERER, giving the ability to exportthe camera data to Blender standaloneand Octane Render for Blender. Checkout the tutorial in the manual.

Phantom Photo Match 1.3

• Fixed problem where the UI didn't updatevariables when importing a setup.

• Added function EXPORT ENVIRONMENTMAP. Allows you to export theenvironment map image as a *.PNG file.

• Added function SCENE ORIGIN OFFSET.Allows you to fly around the imported*.OBJ model in 3D space. You can thenpinpoint a location with the left mousebutton to determine the position thatshould be used for the ORIGIN nodeinside the interface. I t makes dealing withmodels that are far away from theabsolute origin (0,0,0) a lot easier. Noneed to change your model inside therender tool, the offset is taken intoaccount in the exported dataautomatically.

• Added function RESET OFFSET. Resetsthe offset, meaning the ORIGIN node inthe interface will be at position (0,0,0) inyour scene again.

Page 23: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

22 of 25

• Added new module calledENVIRONMENT MAP, targeted towardspainting an environment map for yourscene. An environment map is an imageused for the lighting in your scene. I tallows you to bring in tints of color fromthe environment. That way the scene isblended in much better with thebackground image behind it. Using thepaint tools, you can smoothly paintaround colors as you like. The image canbe exported as *.PNG and used in yourrendering tool as-is.

• Added color indicators to the left side ofthe interface. They allow you to savesome colors in the current setup for quickaccess. Click on the little boxes next to thecolors in the GUI to set the currentlyactive color. When setting the color orpainting, it always applies to the currentlyactive color.

• Added function CURRENT INDEX.Controls the currently active color. Youcan also click inside the little boxes nextto the colors in the GUI to achieve thesame effect.

• Added function SAMPLE ON SHEET. Thisfunction pops up a color sheet andgrayscale sheet, allowing you to changethe currently active color.

• Added function SAMPLE ON IMAGE. Thisfunction lets you change the currentlyactive color to the color of a pixel youpinpoint on the imported image.

• Added function SAMPLE ON IMAGE(BLUR). Same as function SAMPLE ONIMAGE, but this time Phantom PhotoMatch temporarily blurs the importedimage. That way you can get the averagecolor tint of regions in your image, whichis more suitable for drawing on theenvironment map.

• Added function PAINT ENVIRONMENTMAP. This function allows you to paint onthe environment map, located below theimported image in the GUI . Use the leftmouse button to paint where you want.When painting on the left or right edge onthe screen, a clone brush will appear onthe other side. That way the environmentmap will be perfectly seamless all the wayaround. While the tool is activated, youcan use SHIFT+MOUSEWHEEL to changethe brush radius. You can also useCTRL+MOUSEWHEEL to change thepainting intensity. The environment mapwill be saved inside your setup, so youdon't have to be afraid of losing it.

Phantom Photo Match 1.4

• Program now correctly shows up as'Phantom Photo Match' in task manager.

• Program now appears immediately andshows a splash screen as opposed toloading up in the background and thensuddenly appearing.

• Since Phantom Photo Match works withsaving a setup file rather than automaticsaving, closing the program accidentallybefore saving makes you lose your work.To prevent this from happening, you willnow be prompted with a notice if youwant to save the current setup when youclose the program.

Phantom Photo Match 1.4.1

• Fixed problem regarding shaders in thegraphics framework behind the GUI .Imported models now no longer showunlit faces but all come out correctly.

• Added function WIREFRAME. Allows youto toggle on wireframe lines on theimported OBJ.

Page 24: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

23 of 25

Phantom Photo Match 1.4.2(most recent)

• Fixed problem that made the programcrash when pressing the 'Cancel' buttonwhen browsing to a *.OBJ or image file.

Page 25: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

24 of 25

Page 26: Phantom Technology | Software | Algorithms | Game designguusthissen.nl/downloads_photomatch/manual.pdf · d; c 3-/8c>c8:ch: a>8:ch:>hk6a>9;dg6h>c

25 of 25

I hope that Phantom Photo Match technologyprovides a quick & easy instancing solution inyour rendering workflow. My aim is to provide ahigh quality product. The software is designed toexceed in areas where Octane Render andmodeling tools fall short. To fill in a gap in theworkflow. To work smart.

The development team consists of three people:Guus Thissen (lead developer), Jack McCallum(DLL support) and Zachary Reedy (DRM support).

I f you have any suggestions or feature requests,please contact me at [email protected].

Guus ThissenPhantom Photo Match lead developer

Final word