java
/
jMonkeyEngine-wiki
mirror of https://github.com/jMonkeyEngine/wiki.git


			
				
					
						
						
							12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505
							<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="generator" content="Asciidoctor 1.5.4">
<title>Frequently Asked Questions</title>
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700">
<style>
/* Asciidoctor default stylesheet | MIT License | http://asciidoctor.org */
/* Remove comment around @import statement below when using as a custom stylesheet */
/*@import "https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700";*/
article,aside,details,figcaption,figure,footer,header,hgroup,main,nav,section,summary{display:block}
audio,canvas,video{display:inline-block}
audio:not([controls]){display:none;height:0}
[hidden],template{display:none}
script{display:none!important}
html{font-family:sans-serif;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}
body{margin:0}
a{background:transparent}
a:focus{outline:thin dotted}
a:active,a:hover{outline:0}
h1{font-size:2em;margin:.67em 0}
abbr[title]{border-bottom:1px dotted}
b,strong{font-weight:bold}
dfn{font-style:italic}
hr{-moz-box-sizing:content-box;box-sizing:content-box;height:0}
mark{background:#ff0;color:#000}
code,kbd,pre,samp{font-family:monospace;font-size:1em}
pre{white-space:pre-wrap}
q{quotes:"\201C" "\201D" "\2018" "\2019"}
small{font-size:80%}
sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}
sup{top:-.5em}
sub{bottom:-.25em}
img{border:0}
svg:not(:root){overflow:hidden}
figure{margin:0}
fieldset{border:1px solid silver;margin:0 2px;padding:.35em .625em .75em}
legend{border:0;padding:0}
button,input,select,textarea{font-family:inherit;font-size:100%;margin:0}
button,input{line-height:normal}
button,select{text-transform:none}
button,html input[type="button"],input[type="reset"],input[type="submit"]{-webkit-appearance:button;cursor:pointer}
button[disabled],html input[disabled]{cursor:default}
input[type="checkbox"],input[type="radio"]{box-sizing:border-box;padding:0}
input[type="search"]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}
input[type="search"]::-webkit-search-cancel-button,input[type="search"]::-webkit-search-decoration{-webkit-appearance:none}
button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}
textarea{overflow:auto;vertical-align:top}
table{border-collapse:collapse;border-spacing:0}
*,*:before,*:after{-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}
html,body{font-size:100%}
body{background:#fff;color:rgba(0,0,0,.8);padding:0;margin:0;font-family:"Noto Serif","DejaVu Serif",serif;font-weight:400;font-style:normal;line-height:1;position:relative;cursor:auto}
a:hover{cursor:pointer}
img,object,embed{max-width:100%;height:auto}
object,embed{height:100%}
img{-ms-interpolation-mode:bicubic}
.left{float:left!important}
.right{float:right!important}
.text-left{text-align:left!important}
.text-right{text-align:right!important}
.text-center{text-align:center!important}
.text-justify{text-align:justify!important}
.hide{display:none}
body{-webkit-font-smoothing:antialiased}
img,object,svg{display:inline-block;vertical-align:middle}
textarea{height:auto;min-height:50px}
select{width:100%}
.center{margin-left:auto;margin-right:auto}
.spread{width:100%}
p.lead,.paragraph.lead>p,#preamble>.sectionbody>.paragraph:first-of-type p{font-size:1.21875em;line-height:1.6}
.subheader,.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{line-height:1.45;color:#7a2518;font-weight:400;margin-top:0;margin-bottom:.25em}
div,dl,dt,dd,ul,ol,li,h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6,pre,form,p,blockquote,th,td{margin:0;padding:0;direction:ltr}
a{color:#2156a5;text-decoration:underline;line-height:inherit}
a:hover,a:focus{color:#1d4b8f}
a img{border:none}
p{font-family:inherit;font-weight:400;font-size:1em;line-height:1.6;margin-bottom:1.25em;text-rendering:optimizeLegibility}
p aside{font-size:.875em;line-height:1.35;font-style:italic}
h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{font-family:"Open Sans","DejaVu Sans",sans-serif;font-weight:300;font-style:normal;color:#ba3925;text-rendering:optimizeLegibility;margin-top:1em;margin-bottom:.5em;line-height:1.0125em}
h1 small,h2 small,h3 small,#toctitle small,.sidebarblock>.content>.title small,h4 small,h5 small,h6 small{font-size:60%;color:#e99b8f;line-height:0}
h1{font-size:2.125em}
h2{font-size:1.6875em}
h3,#toctitle,.sidebarblock>.content>.title{font-size:1.375em}
h4,h5{font-size:1.125em}
h6{font-size:1em}
hr{border:solid #ddddd8;border-width:1px 0 0;clear:both;margin:1.25em 0 1.1875em;height:0}
em,i{font-style:italic;line-height:inherit}
strong,b{font-weight:bold;line-height:inherit}
small{font-size:60%;line-height:inherit}
code{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;font-weight:400;color:rgba(0,0,0,.9)}
ul,ol,dl{font-size:1em;line-height:1.6;margin-bottom:1.25em;list-style-position:outside;font-family:inherit}
ul,ol,ul.no-bullet,ol.no-bullet{margin-left:1.5em}
ul li ul,ul li ol{margin-left:1.25em;margin-bottom:0;font-size:1em}
ul.square li ul,ul.circle li ul,ul.disc li ul{list-style:inherit}
ul.square{list-style-type:square}
ul.circle{list-style-type:circle}
ul.disc{list-style-type:disc}
ul.no-bullet{list-style:none}
ol li ul,ol li ol{margin-left:1.25em;margin-bottom:0}
dl dt{margin-bottom:.3125em;font-weight:bold}
dl dd{margin-bottom:1.25em}
abbr,acronym{text-transform:uppercase;font-size:90%;color:rgba(0,0,0,.8);border-bottom:1px dotted #ddd;cursor:help}
abbr{text-transform:none}
blockquote{margin:0 0 1.25em;padding:.5625em 1.25em 0 1.1875em;border-left:1px solid #ddd}
blockquote cite{display:block;font-size:.9375em;color:rgba(0,0,0,.6)}
blockquote cite:before{content:"\2014 \0020"}
blockquote cite a,blockquote cite a:visited{color:rgba(0,0,0,.6)}
blockquote,blockquote p{line-height:1.6;color:rgba(0,0,0,.85)}
@media only screen and (min-width:768px){h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2}
h1{font-size:2.75em}
h2{font-size:2.3125em}
h3,#toctitle,.sidebarblock>.content>.title{font-size:1.6875em}
h4{font-size:1.4375em}}
table{background:#fff;margin-bottom:1.25em;border:solid 1px #dedede}
table thead,table tfoot{background:#f7f8f7;font-weight:bold}
table thead tr th,table thead tr td,table tfoot tr th,table tfoot tr td{padding:.5em .625em .625em;font-size:inherit;color:rgba(0,0,0,.8);text-align:left}
table tr th,table tr td{padding:.5625em .625em;font-size:inherit;color:rgba(0,0,0,.8)}
table tr.even,table tr.alt,table tr:nth-of-type(even){background:#f8f8f7}
table thead tr th,table tfoot tr th,table tbody tr td,table tr td,table tfoot tr td{display:table-cell;line-height:1.6}
body{tab-size:4}
h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2;word-spacing:-.05em}
h1 strong,h2 strong,h3 strong,#toctitle strong,.sidebarblock>.content>.title strong,h4 strong,h5 strong,h6 strong{font-weight:400}
.clearfix:before,.clearfix:after,.float-group:before,.float-group:after{content:" ";display:table}
.clearfix:after,.float-group:after{clear:both}
*:not(pre)>code{font-size:.9375em;font-style:normal!important;letter-spacing:0;padding:.1em .5ex;word-spacing:-.15em;background-color:#f7f7f8;-webkit-border-radius:4px;border-radius:4px;line-height:1.45;text-rendering:optimizeSpeed}
pre,pre>code{line-height:1.45;color:rgba(0,0,0,.9);font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;font-weight:400;text-rendering:optimizeSpeed}
.keyseq{color:rgba(51,51,51,.8)}
kbd{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;display:inline-block;color:rgba(0,0,0,.8);font-size:.65em;line-height:1.45;background-color:#f7f7f7;border:1px solid #ccc;-webkit-border-radius:3px;border-radius:3px;-webkit-box-shadow:0 1px 0 rgba(0,0,0,.2),0 0 0 .1em white inset;box-shadow:0 1px 0 rgba(0,0,0,.2),0 0 0 .1em #fff inset;margin:0 .15em;padding:.2em .5em;vertical-align:middle;position:relative;top:-.1em;white-space:nowrap}
.keyseq kbd:first-child{margin-left:0}
.keyseq kbd:last-child{margin-right:0}
.menuseq,.menu{color:rgba(0,0,0,.8)}
b.button:before,b.button:after{position:relative;top:-1px;font-weight:400}
b.button:before{content:"[";padding:0 3px 0 2px}
b.button:after{content:"]";padding:0 2px 0 3px}
p a>code:hover{color:rgba(0,0,0,.9)}
#header,#content,#footnotes,#footer{width:100%;margin-left:auto;margin-right:auto;margin-top:0;margin-bottom:0;max-width:62.5em;*zoom:1;position:relative;padding-left:.9375em;padding-right:.9375em}
#header:before,#header:after,#content:before,#content:after,#footnotes:before,#footnotes:after,#footer:before,#footer:after{content:" ";display:table}
#header:after,#content:after,#footnotes:after,#footer:after{clear:both}
#content{margin-top:1.25em}
#content:before{content:none}
#header>h1:first-child{color:rgba(0,0,0,.85);margin-top:2.25rem;margin-bottom:0}
#header>h1:first-child+#toc{margin-top:8px;border-top:1px solid #ddddd8}
#header>h1:only-child,body.toc2 #header>h1:nth-last-child(2){border-bottom:1px solid #ddddd8;padding-bottom:8px}
#header .details{border-bottom:1px solid #ddddd8;line-height:1.45;padding-top:.25em;padding-bottom:.25em;padding-left:.25em;color:rgba(0,0,0,.6);display:-ms-flexbox;display:-webkit-flex;display:flex;-ms-flex-flow:row wrap;-webkit-flex-flow:row wrap;flex-flow:row wrap}
#header .details span:first-child{margin-left:-.125em}
#header .details span.email a{color:rgba(0,0,0,.85)}
#header .details br{display:none}
#header .details br+span:before{content:"\00a0\2013\00a0"}
#header .details br+span.author:before{content:"\00a0\22c5\00a0";color:rgba(0,0,0,.85)}
#header .details br+span#revremark:before{content:"\00a0|\00a0"}
#header #revnumber{text-transform:capitalize}
#header #revnumber:after{content:"\00a0"}
#content>h1:first-child:not([class]){color:rgba(0,0,0,.85);border-bottom:1px solid #ddddd8;padding-bottom:8px;margin-top:0;padding-top:1rem;margin-bottom:1.25rem}
#toc{border-bottom:1px solid #efefed;padding-bottom:.5em}
#toc>ul{margin-left:.125em}
#toc ul.sectlevel0>li>a{font-style:italic}
#toc ul.sectlevel0 ul.sectlevel1{margin:.5em 0}
#toc ul{font-family:"Open Sans","DejaVu Sans",sans-serif;list-style-type:none}
#toc li{line-height:1.3334;margin-top:.3334em}
#toc a{text-decoration:none}
#toc a:active{text-decoration:underline}
#toctitle{color:#7a2518;font-size:1.2em}
@media only screen and (min-width:768px){#toctitle{font-size:1.375em}
body.toc2{padding-left:15em;padding-right:0}
#toc.toc2{margin-top:0!important;background-color:#f8f8f7;position:fixed;width:15em;left:0;top:0;border-right:1px solid #efefed;border-top-width:0!important;border-bottom-width:0!important;z-index:1000;padding:1.25em 1em;height:100%;overflow:auto}
#toc.toc2 #toctitle{margin-top:0;margin-bottom:.8rem;font-size:1.2em}
#toc.toc2>ul{font-size:.9em;margin-bottom:0}
#toc.toc2 ul ul{margin-left:0;padding-left:1em}
#toc.toc2 ul.sectlevel0 ul.sectlevel1{padding-left:0;margin-top:.5em;margin-bottom:.5em}
body.toc2.toc-right{padding-left:0;padding-right:15em}
body.toc2.toc-right #toc.toc2{border-right-width:0;border-left:1px solid #efefed;left:auto;right:0}}
@media only screen and (min-width:1280px){body.toc2{padding-left:20em;padding-right:0}
#toc.toc2{width:20em}
#toc.toc2 #toctitle{font-size:1.375em}
#toc.toc2>ul{font-size:.95em}
#toc.toc2 ul ul{padding-left:1.25em}
body.toc2.toc-right{padding-left:0;padding-right:20em}}
#content #toc{border-style:solid;border-width:1px;border-color:#e0e0dc;margin-bottom:1.25em;padding:1.25em;background:#f8f8f7;-webkit-border-radius:4px;border-radius:4px}
#content #toc>:first-child{margin-top:0}
#content #toc>:last-child{margin-bottom:0}
#footer{max-width:100%;background-color:rgba(0,0,0,.8);padding:1.25em}
#footer-text{color:rgba(255,255,255,.8);line-height:1.44}
.sect1{padding-bottom:.625em}
@media only screen and (min-width:768px){.sect1{padding-bottom:1.25em}}
.sect1+.sect1{border-top:1px solid #efefed}
#content h1>a.anchor,h2>a.anchor,h3>a.anchor,#toctitle>a.anchor,.sidebarblock>.content>.title>a.anchor,h4>a.anchor,h5>a.anchor,h6>a.anchor{position:absolute;z-index:1001;width:1.5ex;margin-left:-1.5ex;display:block;text-decoration:none!important;visibility:hidden;text-align:center;font-weight:400}
#content h1>a.anchor:before,h2>a.anchor:before,h3>a.anchor:before,#toctitle>a.anchor:before,.sidebarblock>.content>.title>a.anchor:before,h4>a.anchor:before,h5>a.anchor:before,h6>a.anchor:before{content:"\00A7";font-size:.85em;display:block;padding-top:.1em}
#content h1:hover>a.anchor,#content h1>a.anchor:hover,h2:hover>a.anchor,h2>a.anchor:hover,h3:hover>a.anchor,#toctitle:hover>a.anchor,.sidebarblock>.content>.title:hover>a.anchor,h3>a.anchor:hover,#toctitle>a.anchor:hover,.sidebarblock>.content>.title>a.anchor:hover,h4:hover>a.anchor,h4>a.anchor:hover,h5:hover>a.anchor,h5>a.anchor:hover,h6:hover>a.anchor,h6>a.anchor:hover{visibility:visible}
#content h1>a.link,h2>a.link,h3>a.link,#toctitle>a.link,.sidebarblock>.content>.title>a.link,h4>a.link,h5>a.link,h6>a.link{color:#ba3925;text-decoration:none}
#content h1>a.link:hover,h2>a.link:hover,h3>a.link:hover,#toctitle>a.link:hover,.sidebarblock>.content>.title>a.link:hover,h4>a.link:hover,h5>a.link:hover,h6>a.link:hover{color:#a53221}
.audioblock,.imageblock,.literalblock,.listingblock,.stemblock,.videoblock{margin-bottom:1.25em}
.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{text-rendering:optimizeLegibility;text-align:left;font-family:"Noto Serif","DejaVu Serif",serif;font-size:1rem;font-style:italic}
table.tableblock>caption.title{white-space:nowrap;overflow:visible;max-width:0}
.paragraph.lead>p,#preamble>.sectionbody>.paragraph:first-of-type p{color:rgba(0,0,0,.85)}
table.tableblock #preamble>.sectionbody>.paragraph:first-of-type p{font-size:inherit}
.admonitionblock>table{border-collapse:separate;border:0;background:none;width:100%}
.admonitionblock>table td.icon{text-align:center;width:80px}
.admonitionblock>table td.icon img{max-width:none}
.admonitionblock>table td.icon .title{font-weight:bold;font-family:"Open Sans","DejaVu Sans",sans-serif;text-transform:uppercase}
.admonitionblock>table td.content{padding-left:1.125em;padding-right:1.25em;border-left:1px solid #ddddd8;color:rgba(0,0,0,.6)}
.admonitionblock>table td.content>:last-child>:last-child{margin-bottom:0}
.exampleblock>.content{border-style:solid;border-width:1px;border-color:#e6e6e6;margin-bottom:1.25em;padding:1.25em;background:#fff;-webkit-border-radius:4px;border-radius:4px}
.exampleblock>.content>:first-child{margin-top:0}
.exampleblock>.content>:last-child{margin-bottom:0}
.sidebarblock{border-style:solid;border-width:1px;border-color:#e0e0dc;margin-bottom:1.25em;padding:1.25em;background:#f8f8f7;-webkit-border-radius:4px;border-radius:4px}
.sidebarblock>:first-child{margin-top:0}
.sidebarblock>:last-child{margin-bottom:0}
.sidebarblock>.content>.title{color:#7a2518;margin-top:0;text-align:center}
.exampleblock>.content>:last-child>:last-child,.exampleblock>.content .olist>ol>li:last-child>:last-child,.exampleblock>.content .ulist>ul>li:last-child>:last-child,.exampleblock>.content .qlist>ol>li:last-child>:last-child,.sidebarblock>.content>:last-child>:last-child,.sidebarblock>.content .olist>ol>li:last-child>:last-child,.sidebarblock>.content .ulist>ul>li:last-child>:last-child,.sidebarblock>.content .qlist>ol>li:last-child>:last-child{margin-bottom:0}
.literalblock pre,.listingblock pre:not(.highlight),.listingblock pre[class="highlight"],.listingblock pre[class^="highlight "],.listingblock pre.CodeRay,.listingblock pre.prettyprint{background:#f7f7f8}
.sidebarblock .literalblock pre,.sidebarblock .listingblock pre:not(.highlight),.sidebarblock .listingblock pre[class="highlight"],.sidebarblock .listingblock pre[class^="highlight "],.sidebarblock .listingblock pre.CodeRay,.sidebarblock .listingblock pre.prettyprint{background:#f2f1f1}
.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{-webkit-border-radius:4px;border-radius:4px;word-wrap:break-word;padding:1em;font-size:.8125em}
.literalblock pre.nowrap,.literalblock pre[class].nowrap,.listingblock pre.nowrap,.listingblock pre[class].nowrap{overflow-x:auto;white-space:pre;word-wrap:normal}
@media only screen and (min-width:768px){.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{font-size:.90625em}}
@media only screen and (min-width:1280px){.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{font-size:1em}}
.literalblock.output pre{color:#f7f7f8;background-color:rgba(0,0,0,.9)}
.listingblock pre.highlightjs{padding:0}
.listingblock pre.highlightjs>code{padding:1em;-webkit-border-radius:4px;border-radius:4px}
.listingblock pre.prettyprint{border-width:0}
.listingblock>.content{position:relative}
.listingblock code[data-lang]:before{display:none;content:attr(data-lang);position:absolute;font-size:.75em;top:.425rem;right:.5rem;line-height:1;text-transform:uppercase;color:#999}
.listingblock:hover code[data-lang]:before{display:block}
.listingblock.terminal pre .command:before{content:attr(data-prompt);padding-right:.5em;color:#999}
.listingblock.terminal pre .command:not([data-prompt]):before{content:"$"}
table.pyhltable{border-collapse:separate;border:0;margin-bottom:0;background:none}
table.pyhltable td{vertical-align:top;padding-top:0;padding-bottom:0;line-height:1.45}
table.pyhltable td.code{padding-left:.75em;padding-right:0}
pre.pygments .lineno,table.pyhltable td:not(.code){color:#999;padding-left:0;padding-right:.5em;border-right:1px solid #ddddd8}
pre.pygments .lineno{display:inline-block;margin-right:.25em}
table.pyhltable .linenodiv{background:none!important;padding-right:0!important}
.quoteblock{margin:0 1em 1.25em 1.5em;display:table}
.quoteblock>.title{margin-left:-1.5em;margin-bottom:.75em}
.quoteblock blockquote,.quoteblock blockquote p{color:rgba(0,0,0,.85);font-size:1.15rem;line-height:1.75;word-spacing:.1em;letter-spacing:0;font-style:italic;text-align:justify}
.quoteblock blockquote{margin:0;padding:0;border:0}
.quoteblock blockquote:before{content:"\201c";float:left;font-size:2.75em;font-weight:bold;line-height:.6em;margin-left:-.6em;color:#7a2518;text-shadow:0 1px 2px rgba(0,0,0,.1)}
.quoteblock blockquote>.paragraph:last-child p{margin-bottom:0}
.quoteblock .attribution{margin-top:.5em;margin-right:.5ex;text-align:right}
.quoteblock .quoteblock{margin-left:0;margin-right:0;padding:.5em 0;border-left:3px solid rgba(0,0,0,.6)}
.quoteblock .quoteblock blockquote{padding:0 0 0 .75em}
.quoteblock .quoteblock blockquote:before{display:none}
.verseblock{margin:0 1em 1.25em 1em}
.verseblock pre{font-family:"Open Sans","DejaVu Sans",sans;font-size:1.15rem;color:rgba(0,0,0,.85);font-weight:300;text-rendering:optimizeLegibility}
.verseblock pre strong{font-weight:400}
.verseblock .attribution{margin-top:1.25rem;margin-left:.5ex}
.quoteblock .attribution,.verseblock .attribution{font-size:.9375em;line-height:1.45;font-style:italic}
.quoteblock .attribution br,.verseblock .attribution br{display:none}
.quoteblock .attribution cite,.verseblock .attribution cite{display:block;letter-spacing:-.025em;color:rgba(0,0,0,.6)}
.quoteblock.abstract{margin:0 0 1.25em 0;display:block}
.quoteblock.abstract blockquote,.quoteblock.abstract blockquote p{text-align:left;word-spacing:0}
.quoteblock.abstract blockquote:before,.quoteblock.abstract blockquote p:first-of-type:before{display:none}
table.tableblock{max-width:100%;border-collapse:separate}
table.tableblock td>.paragraph:last-child p>p:last-child,table.tableblock th>p:last-child,table.tableblock td>p:last-child{margin-bottom:0}
table.tableblock,th.tableblock,td.tableblock{border:0 solid #dedede}
table.grid-all th.tableblock,table.grid-all td.tableblock{border-width:0 1px 1px 0}
table.grid-all tfoot>tr>th.tableblock,table.grid-all tfoot>tr>td.tableblock{border-width:1px 1px 0 0}
table.grid-cols th.tableblock,table.grid-cols td.tableblock{border-width:0 1px 0 0}
table.grid-all *>tr>.tableblock:last-child,table.grid-cols *>tr>.tableblock:last-child{border-right-width:0}
table.grid-rows th.tableblock,table.grid-rows td.tableblock{border-width:0 0 1px 0}
table.grid-all tbody>tr:last-child>th.tableblock,table.grid-all tbody>tr:last-child>td.tableblock,table.grid-all thead:last-child>tr>th.tableblock,table.grid-rows tbody>tr:last-child>th.tableblock,table.grid-rows tbody>tr:last-child>td.tableblock,table.grid-rows thead:last-child>tr>th.tableblock{border-bottom-width:0}
table.grid-rows tfoot>tr>th.tableblock,table.grid-rows tfoot>tr>td.tableblock{border-width:1px 0 0 0}
table.frame-all{border-width:1px}
table.frame-sides{border-width:0 1px}
table.frame-topbot{border-width:1px 0}
th.halign-left,td.halign-left{text-align:left}
th.halign-right,td.halign-right{text-align:right}
th.halign-center,td.halign-center{text-align:center}
th.valign-top,td.valign-top{vertical-align:top}
th.valign-bottom,td.valign-bottom{vertical-align:bottom}
th.valign-middle,td.valign-middle{vertical-align:middle}
table thead th,table tfoot th{font-weight:bold}
tbody tr th{display:table-cell;line-height:1.6;background:#f7f8f7}
tbody tr th,tbody tr th p,tfoot tr th,tfoot tr th p{color:rgba(0,0,0,.8);font-weight:bold}
p.tableblock>code:only-child{background:none;padding:0}
p.tableblock{font-size:1em}
td>div.verse{white-space:pre}
ol{margin-left:1.75em}
ul li ol{margin-left:1.5em}
dl dd{margin-left:1.125em}
dl dd:last-child,dl dd:last-child>:last-child{margin-bottom:0}
ol>li p,ul>li p,ul dd,ol dd,.olist .olist,.ulist .ulist,.ulist .olist,.olist .ulist{margin-bottom:.625em}
ul.unstyled,ol.unnumbered,ul.checklist,ul.none{list-style-type:none}
ul.unstyled,ol.unnumbered,ul.checklist{margin-left:.625em}
ul.checklist li>p:first-child>.fa-square-o:first-child,ul.checklist li>p:first-child>.fa-check-square-o:first-child{width:1em;font-size:.85em}
ul.checklist li>p:first-child>input[type="checkbox"]:first-child{width:1em;position:relative;top:1px}
ul.inline{margin:0 auto .625em auto;margin-left:-1.375em;margin-right:0;padding:0;list-style:none;overflow:hidden}
ul.inline>li{list-style:none;float:left;margin-left:1.375em;display:block}
ul.inline>li>*{display:block}
.unstyled dl dt{font-weight:400;font-style:normal}
ol.arabic{list-style-type:decimal}
ol.decimal{list-style-type:decimal-leading-zero}
ol.loweralpha{list-style-type:lower-alpha}
ol.upperalpha{list-style-type:upper-alpha}
ol.lowerroman{list-style-type:lower-roman}
ol.upperroman{list-style-type:upper-roman}
ol.lowergreek{list-style-type:lower-greek}
.hdlist>table,.colist>table{border:0;background:none}
.hdlist>table>tbody>tr,.colist>table>tbody>tr{background:none}
td.hdlist1,td.hdlist2{vertical-align:top;padding:0 .625em}
td.hdlist1{font-weight:bold;padding-bottom:1.25em}
.literalblock+.colist,.listingblock+.colist{margin-top:-.5em}
.colist>table tr>td:first-of-type{padding:0 .75em;line-height:1}
.colist>table tr>td:last-of-type{padding:.25em 0}
.thumb,.th{line-height:0;display:inline-block;border:solid 4px #fff;-webkit-box-shadow:0 0 0 1px #ddd;box-shadow:0 0 0 1px #ddd}
.imageblock.left,.imageblock[style*="float: left"]{margin:.25em .625em 1.25em 0}
.imageblock.right,.imageblock[style*="float: right"]{margin:.25em 0 1.25em .625em}
.imageblock>.title{margin-bottom:0}
.imageblock.thumb,.imageblock.th{border-width:6px}
.imageblock.thumb>.title,.imageblock.th>.title{padding:0 .125em}
.image.left,.image.right{margin-top:.25em;margin-bottom:.25em;display:inline-block;line-height:0}
.image.left{margin-right:.625em}
.image.right{margin-left:.625em}
a.image{text-decoration:none;display:inline-block}
a.image object{pointer-events:none}
sup.footnote,sup.footnoteref{font-size:.875em;position:static;vertical-align:super}
sup.footnote a,sup.footnoteref a{text-decoration:none}
sup.footnote a:active,sup.footnoteref a:active{text-decoration:underline}
#footnotes{padding-top:.75em;padding-bottom:.75em;margin-bottom:.625em}
#footnotes hr{width:20%;min-width:6.25em;margin:-.25em 0 .75em 0;border-width:1px 0 0 0}
#footnotes .footnote{padding:0 .375em 0 .225em;line-height:1.3334;font-size:.875em;margin-left:1.2em;text-indent:-1.05em;margin-bottom:.2em}
#footnotes .footnote a:first-of-type{font-weight:bold;text-decoration:none}
#footnotes .footnote:last-of-type{margin-bottom:0}
#content #footnotes{margin-top:-.625em;margin-bottom:0;padding:.75em 0}
.gist .file-data>table{border:0;background:#fff;width:100%;margin-bottom:0}
.gist .file-data>table td.line-data{width:99%}
div.unbreakable{page-break-inside:avoid}
.big{font-size:larger}
.small{font-size:smaller}
.underline{text-decoration:underline}
.overline{text-decoration:overline}
.line-through{text-decoration:line-through}
.aqua{color:#00bfbf}
.aqua-background{background-color:#00fafa}
.black{color:#000}
.black-background{background-color:#000}
.blue{color:#0000bf}
.blue-background{background-color:#0000fa}
.fuchsia{color:#bf00bf}
.fuchsia-background{background-color:#fa00fa}
.gray{color:#606060}
.gray-background{background-color:#7d7d7d}
.green{color:#006000}
.green-background{background-color:#007d00}
.lime{color:#00bf00}
.lime-background{background-color:#00fa00}
.maroon{color:#600000}
.maroon-background{background-color:#7d0000}
.navy{color:#000060}
.navy-background{background-color:#00007d}
.olive{color:#606000}
.olive-background{background-color:#7d7d00}
.purple{color:#600060}
.purple-background{background-color:#7d007d}
.red{color:#bf0000}
.red-background{background-color:#fa0000}
.silver{color:#909090}
.silver-background{background-color:#bcbcbc}
.teal{color:#006060}
.teal-background{background-color:#007d7d}
.white{color:#bfbfbf}
.white-background{background-color:#fafafa}
.yellow{color:#bfbf00}
.yellow-background{background-color:#fafa00}
span.icon>.fa{cursor:default}
.admonitionblock td.icon [class^="fa icon-"]{font-size:2.5em;text-shadow:1px 1px 2px rgba(0,0,0,.5);cursor:default}
.admonitionblock td.icon .icon-note:before{content:"\f05a";color:#19407c}
.admonitionblock td.icon .icon-tip:before{content:"\f0eb";text-shadow:1px 1px 2px rgba(155,155,0,.8);color:#111}
.admonitionblock td.icon .icon-warning:before{content:"\f071";color:#bf6900}
.admonitionblock td.icon .icon-caution:before{content:"\f06d";color:#bf3400}
.admonitionblock td.icon .icon-important:before{content:"\f06a";color:#bf0000}
.conum[data-value]{display:inline-block;color:#fff!important;background-color:rgba(0,0,0,.8);-webkit-border-radius:100px;border-radius:100px;text-align:center;font-size:.75em;width:1.67em;height:1.67em;line-height:1.67em;font-family:"Open Sans","DejaVu Sans",sans-serif;font-style:normal;font-weight:bold}
.conum[data-value] *{color:#fff!important}
.conum[data-value]+b{display:none}
.conum[data-value]:after{content:attr(data-value)}
pre .conum[data-value]{position:relative;top:-.125em}
b.conum *{color:inherit!important}
.conum:not([data-value]):empty{display:none}
dt,th.tableblock,td.content,div.footnote{text-rendering:optimizeLegibility}
h1,h2,p,td.content,span.alt{letter-spacing:-.01em}
p strong,td.content strong,div.footnote strong{letter-spacing:-.005em}
p,blockquote,dt,td.content,span.alt{font-size:1.0625rem}
p{margin-bottom:1.25rem}
.sidebarblock p,.sidebarblock dt,.sidebarblock td.content,p.tableblock{font-size:1em}
.exampleblock>.content{background-color:#fffef7;border-color:#e0e0dc;-webkit-box-shadow:0 1px 4px #e0e0dc;box-shadow:0 1px 4px #e0e0dc}
.print-only{display:none!important}
@media print{@page{margin:1.25cm .75cm}
*{-webkit-box-shadow:none!important;box-shadow:none!important;text-shadow:none!important}
a{color:inherit!important;text-decoration:underline!important}
a.bare,a[href^="#"],a[href^="mailto:"]{text-decoration:none!important}
a[href^="http:"]:not(.bare):after,a[href^="https:"]:not(.bare):after{content:"(" attr(href) ")";display:inline-block;font-size:.875em;padding-left:.25em}
abbr[title]:after{content:" (" attr(title) ")"}
pre,blockquote,tr,img,object,svg{page-break-inside:avoid}
thead{display:table-header-group}
svg{max-width:100%}
p,blockquote,dt,td.content{font-size:1em;orphans:3;widows:3}
h2,h3,#toctitle,.sidebarblock>.content>.title{page-break-after:avoid}
#toc,.sidebarblock,.exampleblock>.content{background:none!important}
#toc{border-bottom:1px solid #ddddd8!important;padding-bottom:0!important}
.sect1{padding-bottom:0!important}
.sect1+.sect1{border:0!important}
#header>h1:first-child{margin-top:1.25rem}
body.book #header{text-align:center}
body.book #header>h1:first-child{border:0!important;margin:2.5em 0 1em 0}
body.book #header .details{border:0!important;display:block;padding:0!important}
body.book #header .details span:first-child{margin-left:0!important}
body.book #header .details br{display:block}
body.book #header .details br+span:before{content:none!important}
body.book #toc{border:0!important;text-align:left!important;padding:0!important;margin:0!important}
body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-break-before:always}
.listingblock code[data-lang]:before{display:block}
#footer{background:none!important;padding:0 .9375em}
#footer-text{color:rgba(0,0,0,.6)!important;font-size:.9em}
.hide-on-print{display:none!important}
.print-only{display:block!important}
.hide-for-print{display:none!important}
.show-for-print{display:inherit!important}}
</style>
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.5.0/css/font-awesome.min.css">
<style>
/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */
/*pre.CodeRay {background-color:#f7f7f8;}*/
.CodeRay .line-numbers{border-right:1px solid #d8d8d8;padding:0 0.5em 0 .25em}
.CodeRay span.line-numbers{display:inline-block;margin-right:.5em;color:rgba(0,0,0,.3)}
.CodeRay .line-numbers strong{color:rgba(0,0,0,.4)}
table.CodeRay{border-collapse:separate;border-spacing:0;margin-bottom:0;border:0;background:none}
table.CodeRay td{vertical-align: top;line-height:1.45}
table.CodeRay td.line-numbers{text-align:right}
table.CodeRay td.line-numbers>pre{padding:0;color:rgba(0,0,0,.3)}
table.CodeRay td.code{padding:0 0 0 .5em}
table.CodeRay td.code>pre{padding:0}
.CodeRay .debug{color:#fff !important;background:#000080 !important}
.CodeRay .annotation{color:#007}
.CodeRay .attribute-name{color:#000080}
.CodeRay .attribute-value{color:#700}
.CodeRay .binary{color:#509}
.CodeRay .comment{color:#998;font-style:italic}
.CodeRay .char{color:#04d}
.CodeRay .char .content{color:#04d}
.CodeRay .char .delimiter{color:#039}
.CodeRay .class{color:#458;font-weight:bold}
.CodeRay .complex{color:#a08}
.CodeRay .constant,.CodeRay .predefined-constant{color:#008080}
.CodeRay .color{color:#099}
.CodeRay .class-variable{color:#369}
.CodeRay .decorator{color:#b0b}
.CodeRay .definition{color:#099}
.CodeRay .delimiter{color:#000}
.CodeRay .doc{color:#970}
.CodeRay .doctype{color:#34b}
.CodeRay .doc-string{color:#d42}
.CodeRay .escape{color:#666}
.CodeRay .entity{color:#800}
.CodeRay .error{color:#808}
.CodeRay .exception{color:inherit}
.CodeRay .filename{color:#099}
.CodeRay .function{color:#900;font-weight:bold}
.CodeRay .global-variable{color:#008080}
.CodeRay .hex{color:#058}
.CodeRay .integer,.CodeRay .float{color:#099}
.CodeRay .include{color:#555}
.CodeRay .inline{color:#000}
.CodeRay .inline .inline{background:#ccc}
.CodeRay .inline .inline .inline{background:#bbb}
.CodeRay .inline .inline-delimiter{color:#d14}
.CodeRay .inline-delimiter{color:#d14}
.CodeRay .important{color:#555;font-weight:bold}
.CodeRay .interpreted{color:#b2b}
.CodeRay .instance-variable{color:#008080}
.CodeRay .label{color:#970}
.CodeRay .local-variable{color:#963}
.CodeRay .octal{color:#40e}
.CodeRay .predefined{color:#369}
.CodeRay .preprocessor{color:#579}
.CodeRay .pseudo-class{color:#555}
.CodeRay .directive{font-weight:bold}
.CodeRay .type{font-weight:bold}
.CodeRay .predefined-type{color:inherit}
.CodeRay .reserved,.CodeRay .keyword {color:#000;font-weight:bold}
.CodeRay .key{color:#808}
.CodeRay .key .delimiter{color:#606}
.CodeRay .key .char{color:#80f}
.CodeRay .value{color:#088}
.CodeRay .regexp .delimiter{color:#808}
.CodeRay .regexp .content{color:#808}
.CodeRay .regexp .modifier{color:#808}
.CodeRay .regexp .char{color:#d14}
.CodeRay .regexp .function{color:#404;font-weight:bold}
.CodeRay .string{color:#d20}
.CodeRay .string .string .string{background:#ffd0d0}
.CodeRay .string .content{color:#d14}
.CodeRay .string .char{color:#d14}
.CodeRay .string .delimiter{color:#d14}
.CodeRay .shell{color:#d14}
.CodeRay .shell .delimiter{color:#d14}
.CodeRay .symbol{color:#990073}
.CodeRay .symbol .content{color:#a60}
.CodeRay .symbol .delimiter{color:#630}
.CodeRay .tag{color:#008080}
.CodeRay .tag-special{color:#d70}
.CodeRay .variable{color:#036}
.CodeRay .insert{background:#afa}
.CodeRay .delete{background:#faa}
.CodeRay .change{color:#aaf;background:#007}
.CodeRay .head{color:#f8f;background:#505}
.CodeRay .insert .insert{color:#080}
.CodeRay .delete .delete{color:#800}
.CodeRay .change .change{color:#66f}
.CodeRay .head .head{color:#f4f}
</style>
</head>
<body class="article toc2 toc-left">
<div id="header">
<h1>Frequently Asked Questions</h1>
<div id="toc" class="toc2">
<div id="toctitle">Table of Contents</div>
<ul class="sectlevel1">
<li><a href="#i-want-to-create-and-configure-a-jme3-application">I want to create and configure a jME3 Application</a>
<ul class="sectlevel2">
<li><a href="#how-do-i-start-writing-a-preconfigured-jme-game">How do I start writing a preconfigured jME game?</a></li>
<li><a href="#how-do-i-change-the-background-color">How do I change the background color?</a></li>
<li><a href="#can-i-customize-the-simpleapplication-class">Can I customize the SimpleApplication class?</a></li>
<li><a href="#how-can-i-switch-between-screens-or-states">How can I switch between screens or states?</a></li>
<li><a href="#how-do-i-pause-unpause-a-game">How do I pause/unpause a game?</a></li>
<li><a href="#how-do-i-disable-logger-output-to-the-console">How do I disable logger output to the console?</a></li>
<li><a href="#why-does-the-executable-crash-with-cannot-locate-resource">Why does the executable crash with "Cannot locate resource"?</a></li>
<li><a href="#what-is-java-lang-linkageerror-version-mismatch">What is java.lang.LinkageError: Version mismatch?</a></li>
</ul>
</li>
<li><a href="#i-want-to-load-my-scene">I want to load my scene</a>
<ul class="sectlevel2">
<li><a href="#how-do-i-make-objects-appear-disappear-in-the-3d-scene">How do I make objects appear / disappear in the 3D scene?</a></li>
<li><a href="#why-do-i-get-assetnotfoundexception-when-loading-x">Why do I get AssetNotFoundException when loading X ?</a></li>
<li><a href="#how-do-i-create-3-d-models-textures-sounds">How do I Create 3-D models, textures, sounds?</a></li>
<li><a href="#how-do-i-load-a-3-d-model-into-the-scene">How do I load a 3-D model into the scene?</a></li>
<li><a href="#how-do-initialize-the-scene">How do initialize the scene?</a></li>
</ul>
</li>
<li><a href="#i-want-to-transform-objects-in-the-scene">I want to transform objects in the scene</a>
<ul class="sectlevel2">
<li><a href="#how-do-i-move-or-turn-or-resize-a-spatial">How do I move or turn or resize a spatial?</a></li>
<li><a href="#how-do-i-make-a-spatial-move-by-itself">How do I make a spatial move by itself?</a></li>
<li><a href="#how-do-i-access-a-named-sub-mesh-in-model">How do I access a named sub-mesh in Model?</a></li>
<li><a href="#how-do-i-make-procedural-or-custom-shapes">How do I make procedural or custom shapes?</a></li>
</ul>
</li>
<li><a href="#i-want-to-change-the-surface-of-objects-in-the-scene">I want to change the surface of objects in the scene</a>
<ul class="sectlevel2">
<li><a href="#why-is-my-uv-wrapping-texture-appearance-all-wrong">Why is my UV wrapping / texture appearance all wrong?</a></li>
<li><a href="#how-do-i-scale-mirror-or-wrap-a-texture">How do I scale, mirror, or wrap a texture?</a></li>
<li><a href="#how-do-i-change-color-or-shininess-of-an-material">How do I change color or shininess of an material?</a></li>
<li><a href="#how-do-i-make-a-surface-wood-stone-metal-etc">How do I make a surface wood, stone, metal, etc?</a></li>
<li><a href="#why-are-materials-too-bright-too-dark-or-flickering">Why are materials too bright, too dark, or flickering?</a></li>
<li><a href="#how-do-i-make-geometries-cast-a-shadow">How do I make geometries cast a shadow?</a></li>
<li><a href="#how-do-i-make-materials-transparent">How do I make materials transparent?</a></li>
<li><a href="#how-do-i-force-or-disable-culling">How do I force or disable culling?</a></li>
<li><a href="#can-i-draw-only-an-outline-of-the-scene">Can I draw only an outline of the scene?</a></li>
</ul>
</li>
<li><a href="#i-want-to-control-the-camera">I want to control the camera</a>
<ul class="sectlevel2">
<li><a href="#how-do-i-keep-the-camera-from-moving">How do I keep the camera from moving?</a></li>
<li><a href="#how-do-i-switch-between-third-person-and-first-person-view">How do I switch between third-person and first-person view ?</a></li>
<li><a href="#how-do-i-increase-camera-speed">How do I increase camera speed?</a></li>
</ul>
</li>
<li><a href="#actions-interactions-physics">Actions, Interactions, Physics</a>
<ul class="sectlevel2">
<li><a href="#how-do-i-implement-game-logic-game-mechanics">How do I implement game logic / game mechanics?</a></li>
<li><a href="#how-do-i-let-players-interact-via-keyboard">How do I let players interact via keyboard?</a></li>
<li><a href="#how-do-i-let-players-interact-by-clicking">How do I let players interact by clicking?</a></li>
<li><a href="#how-do-i-animate-characters">How do I animate characters?</a></li>
<li><a href="#how-do-i-keep-players-from-falling-through-walls-and-floors">How do I keep players from falling through walls and floors?</a></li>
<li><a href="#how-do-i-make-balls-wheels-etc-bounce-and-roll">How do I make balls/wheels/etc bounce and roll?</a></li>
<li><a href="#how-do-i-debug-weird-physics-behaviour">How do I debug weird Physics behaviour?</a></li>
<li><a href="#how-do-i-make-a-walking-character">How do I make a walking character?</a></li>
<li><a href="#how-do-i-steer-vehicles">How do I steer vehicles?</a></li>
<li><a href="#can-objects-swing-like-a-pendulums-chains-ropebridges">Can objects swing like a pendulums, chains, ropebridges?</a></li>
</ul>
</li>
<li><a href="#default-gui-display">Default GUI Display</a>
<ul class="sectlevel2">
<li><a href="#what-are-these-fps-objects-vertices-triangles-statistics">What are these FPS/Objects/Vertices/Triangles statistics?</a></li>
<li><a href="#how-do-i-get-rid-of-the-fps-objects-statistics">How do I get rid of the FPS/Objects statistics?</a></li>
<li><a href="#how-do-i-display-score-health-mini-maps-status-icons">How do I display score, health, mini-maps, status icons?</a></li>
<li><a href="#how-do-i-display-buttons-and-ui-controls">How do I display buttons and UI controls?</a></li>
<li><a href="#how-do-i-display-a-loading-screen">How do i display a loading screen?</a></li>
</ul>
</li>
<li><a href="#nifty-gui">Nifty GUI</a>
<ul class="sectlevel2">
<li><a href="#i-get-nosuchelementexception-when-adding-controls-buttons-etc">I get NoSuchElementException when adding controls (buttons etc)!</a></li>
<li><a href="#where-can-i-find-example-code-of-nifty-gui-s-xml-and-java-classes">Where can I find example code of Nifty GUI&#8217;s XML and Java classes?</a></li>
<li><a href="#is-there-java-doc-for-nifty-gui">Is there Java Doc for Nifty GUI?</a></li>
</ul>
</li>
<li><a href="#i-want-to-create-an-environment-with-sounds-effects-and-landscapes">I want to create an environment with sounds, effects, and landscapes</a>
<ul class="sectlevel2">
<li><a href="#how-do-i-play-sounds-and-noises">How do I play sounds and noises?</a></li>
<li><a href="#how-do-i-make-fire-smoke-explosions-swarms-magic-spells">How do I make fire, smoke, explosions, swarms, magic spells?</a></li>
<li><a href="#how-do-i-make-water-waves-reflections">How do I make water, waves, reflections?</a></li>
<li><a href="#how-do-i-make-fog-bloom-blur-light-scattering">How do I make fog, bloom, blur, light scattering?</a></li>
<li><a href="#how-do-i-generate-a-terrain">How do I generate a terrain?</a></li>
<li><a href="#how-do-i-make-a-sky">How do I make a sky?</a></li>
</ul>
</li>
<li><a href="#i-want-to-access-to-back-end-properties">I want to access to back-end properties</a>
<ul class="sectlevel2">
<li><a href="#how-do-i-read-out-graphic-card-capabilities">How do I read out graphic card capabilities?</a></li>
<li><a href="#how-do-i-run-jmonkeyengine-3-with-opengl1">How do I Run jMonkeyEngine 3 with OpenGL1?</a></li>
<li><a href="#how-do-i-optimize-the-heck-out-of-the-scene-graph">How do I optimize the heck out of the Scene Graph?</a></li>
<li><a href="#how-do-i-prevent-users-from-unzipping-my-jar">How do I prevent users from unzipping my JAR?</a></li>
</ul>
</li>
<li><a href="#i-want-to-do-maths">I want to do maths</a>
<ul class="sectlevel2">
<li><a href="#what-does-addlocal-multlocal-etc-mean">What does addLocal() / multLocal() etc mean?</a></li>
<li><a href="#what-is-the-difference-between-world-and-local-coordinates">What is the difference between World and Local coordinates?</a></li>
<li><a href="#how-do-i-convert-degrees-to-radians">How do I convert Degrees to Radians?</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div id="content">
<div class="sect1">
<h2 id="i-want-to-create-and-configure-a-jme3-application">I want to create and configure a jME3 Application</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="how-do-i-start-writing-a-preconfigured-jme-game">How do I start writing a preconfigured jME game?</h3>
<div class="paragraph">
<p>Write a Java class that extends <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-core/src/main/java/com/jme3/app/SimpleApplication.java">com.jme3.app.SimpleApplication</a>.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/beginner/hello_simpleapplication.html">Hello SimpleApplication</a>, <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/app/TestAppStateLifeCycle.java">TestAppStateLifeCycle</a>.</p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-change-the-background-color">How do I change the background color?</h3>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----viewPort.setBackgroundColor(ColorRGBA.Blue);----</code></pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="can-i-customize-the-simpleapplication-class">Can I customize the SimpleApplication class?</h3>
<div class="paragraph">
<p>Yes! Actually, you MUST customize it! For your own games, you always create a custom base class that extends <a href="http://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/core/com/jme3/app/SimpleApplication.java">com.jme3.app.SimpleApplication</a> class. From now on it&#8217;s no longer a “simple application – it&#8217;s now your game. Configure your <a href="jme3/intermediate/appsettings.html">application settings</a>, implement methods, and customize away!</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/intermediate/simpleapplication.html">SimpleApplication</a>, <a href="jme3/intermediate/appsettings.html">AppSettings</a>.</p>
</div>
</div>
<div class="sect2">
<h3 id="how-can-i-switch-between-screens-or-states">How can I switch between screens or states?</h3>
<div class="paragraph">
<p>You should break down your application logic into components by spreading it out over individual AppStates. AppStates can be attached to and detached from the game. AppStates have access to all objects (rootNode, PhysicsSpace, inputManager, etc) and methods in your main application. So each AppState can bring its own subset of input handlers, <abbr title="Graphical User Interface">GUI</abbr> nodes, spatial nodes, and even its own subset of game mechanics in the update() loop.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/advanced/application_states.html">Application States</a>.</p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-pause-unpause-a-game">How do I pause/unpause a game?</h3>
<div class="paragraph">
<p>You split up your application into several AppStates and implement the setEnabled() methods for each state. Then you create, for example, a GameRunningAppState and a GamePausedAppState. GamePausedAppState&#8217;s job is to attach all your AppStates that contain the logic and <abbr title="Graphical User Interface">GUI</abbr> of the pause screen, and to detach all the AppStates that contain logic and <abbr title="Graphical User Interface">GUI</abbr> of the running game. GameRunningAppState does the opposite. By attaching one or the other to the game, you switch between the paused and unpaused states.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/advanced/application_states.html">Application States</a>.</p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-disable-logger-output-to-the-console">How do I disable logger output to the console?</h3>
<div class="paragraph">
<p>During development, you can switch the severity level of the default logger to no longer print FINE warnings, but only WARNINGs.</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----java.util.logging.Logger.getLogger(<span class="string"><span class="delimiter">&quot;</span><span class="delimiter">&quot;</span></span>).setLevel(<span class="predefined-type">Level</span>.WARNING);----
For the release, <span class="keyword">switch</span> the severity level of the <span class="keyword">default</span> logger to print only SEVERE errors.</code></pre>
</div>
</div>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----java.util.logging.Logger.getLogger(<span class="string"><span class="delimiter">&quot;</span><span class="delimiter">&quot;</span></span>).setLevel(<span class="predefined-type">Level</span>.SEVERE);----
*Learn more:*  &lt;&lt;jme3/advanced/logging<span class="error">#</span>,Logging&gt;&gt;.</code></pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="why-does-the-executable-crash-with-cannot-locate-resource">Why does the executable crash with "Cannot locate resource"?</h3>
<div class="paragraph">
<p>Make sure to only load() models converted to .j3o binary format, not the original Ogre or Wavefront formats. If you load assets from zip files, make sure to ammend the build script to copy them to the build directory.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/advanced/asset_manager.html">Asset Manager</a></p>
</div>
</div>
<div class="sect2">
<h3 id="what-is-java-lang-linkageerror-version-mismatch">What is java.lang.LinkageError: Version mismatch?</h3>
<div class="paragraph">
<p>This rare exception shows a message similar to the following: <code>Exception in thread “LWJGL Renderer Thread java.lang.LinkageError: Version mismatch: jar version is (number), native library version is (another number)</code>. jME3 needs native libraries (.dll, .jnilib, lib*.so files) to run LWJGL and jBullet. The correct versions of these libraries are included when you install the SDK or download the binaries. However there are circumstances where jME3 cannot determine which copy of the native library it should use:<br>
If you install another application that needs a different version of a native library, and this app globally installs its version over jME3&#8217;s; or if an old copy of a native library is in your project directory, your home directory, or Java library path, or in the classpath; or if you permanently linked an old copy in your IDE&#8217;s settings; then Java assumes you prefer these native libraries over the bundled ones, and your jME3 application ends up running with the wrong version.<br>
To fix this, search for .dll (Windows), .jnilib (Mac), and .so (Linux) files for jBullet and LWJGL on your harddrive and in your path and IDE settings, and verify they don&#8217;t interfere. (If you have other jME  versions installed and linked somehow, the outdated natives may also be in a lwjgl.jar or jbullet.jar file!)</p>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="i-want-to-load-my-scene">I want to load my scene</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="how-do-i-make-objects-appear-disappear-in-the-3d-scene">How do I make objects appear / disappear in the 3D scene?</h3>
<div class="paragraph">
<p>To make a spatial appear in the scene, you attach it to the rootNode (or to a node that is attached to the rootnode). To remove a spatial, you detach it from its parent node.</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----rootNode.attachChild(spatial); <span class="comment">// appear in scene----</span>
[source,java]
----rootNode.detachChild(spatial); <span class="comment">// remove from scene----</span>
*Learn more:* &lt;&lt;jme3/the_scene_graph<span class="error">#</span>,The Scene Graph&gt;&gt;, &lt;&lt;jme3/beginner/hello_node<span class="error">#</span>,Hello Node&gt;&gt;, &lt;&lt;jme3/beginner/hello_asset<span class="error">#</span>,Hello Asset&gt;&gt;, &lt;&lt;jme3/advanced/spatial<span class="error">#</span>,Spatial&gt;&gt;, link:https:<span class="comment">//github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-core/src/main/java/com/jme3/scene/Node.java[com.jme3.scene.Node] and link:https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-core/src/main/java/com/jme3/scene/Geometry.java[com.jme3.scene.Geometry].</span></code></pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="why-do-i-get-assetnotfoundexception-when-loading-x">Why do I get AssetNotFoundException when loading X ?</h3>
<div class="paragraph">
<p>First check whether the file path of the asset is correct. By default it is relative to your project&#8217;s assets directory:</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----<span class="comment">// To load .../jMonkeyProjects/MyGame/assets/Models/Ninja/Ninja.j3o</span>
Spatial ninja = assetManager.loadModel(<span class="string"><span class="delimiter">&quot;</span><span class="content">Models/Ninja/Ninja.j3o</span><span class="delimiter">&quot;</span></span>);----
If you are not using the <span class="keyword">default</span> <span class="error">`</span>assets<span class="error">`</span> directory, verify that you have registered a locator to the AssetManager. link:http:<span class="comment">//jmonkeyengine.org/javadoc/com/jme3/asset/plugins/package-summary.html[Different Locator types] are available.</span></code></pre>
</div>
</div>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java"><span class="local-variable">this</span>.assetManager.registerLocator(<span class="string"><span class="delimiter">&quot;</span><span class="content">assets/</span><span class="delimiter">&quot;</span></span>, FileLocator.class); <span class="comment">// default</span>
<span class="local-variable">this</span>.assetManager.registerLocator(<span class="string"><span class="delimiter">&quot;</span><span class="content">c:/jme3User/JMEisSoCool/myAwesomeFolder/</span><span class="delimiter">&quot;</span></span>, FileLocator.class);
<span class="local-variable">this</span>.assetManager.registerLocator(<span class="string"><span class="delimiter">&quot;</span><span class="content">town.zip</span><span class="delimiter">&quot;</span></span>, ZipLocator.class);</code></pre>
</div>
</div>
<div class="paragraph">
<p>Note that you should not register every single folder containing a texture as the assetmanager will not be able to discern between images with the same name anymore.
<strong>Learn more:</strong> <a href="jme3/advanced/asset_manager.html">Asset Manager</a></p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-create-3-d-models-textures-sounds">How do I Create 3-D models, textures, sounds?</h3>
<div class="paragraph">
<p>Follow our best practices for the <a href="jme3/intermediate/multi-media_asset_pipeline.html">multi-media asset pipeline</a>.<br></p>
</div>
<div class="paragraph">
<p>You create 3-D models in a 3-D mesh editor, for example Blender, and export it in Ogre Mesh XML (animated objects, scenes) or Wavefront OBJ format (static objects, scenes).
You create textures in a graphic editor, for example Gimp, and export them as PNG or JPG.
You create sounds in an audio editor, for example, Audacity, and export them as WAVE or OGG.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/advanced/3d_models.html">3D Models</a>,  <a href="jme3/intermediate/multi-media_asset_pipeline.html">Multi-Media Asset Pipeline</a>, <a href="sdk/blender.html">JME3&#8217;s blend-to-j3o importer</a>;<br>
<a href="http://blender.org">Download Blender</a>, <a href="http://en.wikibooks.org/wiki/Blender_3D:_Noob_to_Pro">Blender intro tutorial</a>, <a href="http://www.ogre3d.org/wiki/index.php/Blender_Exporter">Blender-to-Ogre plugin</a>, <a href="http://en.wikipedia.org/wiki/Comparison_of_3D_computer_graphics_software#Features">Comparison of 3D graphic software features (Wikipedia)</a>.</p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-load-a-3-d-model-into-the-scene">How do I load a 3-D model into the scene?</h3>
<div class="paragraph">
<p>Use the jMonkeyEngine SDK to convert models from Ogre XML or Wavefront OBJ formats to .j3o binary format. Load the .j3o file using the AssetManager.</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----<span class="comment">// To load .../jMonkeyProjects/MyGame/assets/Models/Ninja/Ninja.j3o</span>
Spatial ninja = assetManager.loadModel(<span class="string"><span class="delimiter">&quot;</span><span class="content">Models/Ninja/Ninja.j3o</span><span class="delimiter">&quot;</span></span>);----
*Learn more:* &lt;&lt;jme3/beginner/hello_asset<span class="error">#</span>,Hello Asset&gt;&gt;, &lt;&lt;jme3/advanced/asset_manager<span class="error">#</span>,Asset Manager&gt;&gt;, link:https:<span class="comment">//github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-core/src/main/java/com/jme3/asset/AssetManager.java[come.jme3.assets.AssetManager], link:https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-core/src/main/java/com/jme3/scene/Geometry.java[com.jme3.scene.Geometry], &lt;&lt;sdk/model_loader_and_viewer#,jMonkeyEngine SDK j3o converter&gt;&gt;,</span></code></pre>
</div>
</div>
<div class="paragraph">
<p>+
<strong>Code sample:</strong> <a href="http://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/test/jme3test/model/TestOgreLoading.java">TestOgreLoading.java</a>, <a href="http://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/test/jme3test/export/TestOgreConvert.java">TestOgreConvert.java</a>.</p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-initialize-the-scene">How do initialize the scene?</h3>
<div class="paragraph">
<p>Use the simpleInitApp() method in SimpleApplication (or initApp() in Application).</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/beginner/hello_simpleapplication.html">Hello SimpleApplication</a>, <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-core/src/main/java/com/jme3/app/SimpleApplication.java">SimpleApplication.java</a>.</p>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="i-want-to-transform-objects-in-the-scene">I want to transform objects in the scene</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="how-do-i-move-or-turn-or-resize-a-spatial">How do I move or turn or resize a spatial?</h3>
<div class="paragraph">
<p>To move or turn or resize a spatial you use transformations. You can concatenate transformations (e.g. perform rotations around several axes in one step using a Quaternion with <code>slerp()</code> or a com.jme3.math.Transform with interpolateTransforms().</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----spatial.setLocalTranslation(<span class="integer">1</span>,-<span class="integer">3</span>,<span class="float">2.5f</span>); spatial.rotate(<span class="integer">0</span>,<span class="float">3.14f</span>,<span class="integer">0</span>); spatial.scale(<span class="integer">2</span>,<span class="integer">2</span>,<span class="integer">2</span>);----
*Learn more:* &lt;&lt;jme3/beginner/hello_node<span class="error">#</span>,Hello Node&gt;&gt;, &lt;&lt;jme3/advanced/spatial<span class="error">#</span>,Spatial&gt;&gt;, &lt;&lt;jme3/math_for_dummies<span class="error">#</span>,math_for_dummies&gt;&gt;.</code></pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-make-a-spatial-move-by-itself">How do I make a spatial move by itself?</h3>
<div class="paragraph">
<p>Change the geometry&#8217;s translation (position) live in the update loop using setLocalTranslation() for non-physical and applyForce() or setWalkDirection() for physical objects. You can also define and remote-control a spatial&#8217;s motion using <a href="jme3/advanced/cinematics.html">Cinematics</a>, e.g. to record cutscenes, or to implement mobile platforms, elevators, airships, etc.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/beginner/hello_main_event_loop.html">Hello Loop</a>, <a href="jme3/advanced/update_loop.html">Update Loop</a>, <a href="jme3/advanced/custom_controls.html">Custom Controls</a>, <a href="jme3/advanced/cinematics.html">Cinematics</a></p>
</div>
<div class="paragraph">
<p>+
<strong>Code sample:</strong> <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/material/TestBumpModel.java">TestBumpModel.java</a>, <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/model/TestOgreLoading.java">TestOgreLoading.java</a></p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-access-a-named-sub-mesh-in-model">How do I access a named sub-mesh in Model?</h3>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----Geometry submesh = (Geometry) model.getChild(<span class="string"><span class="delimiter">&quot;</span><span class="content">door 12</span><span class="delimiter">&quot;</span></span>);----
*Learn more:* &lt;&lt;jme3/advanced/spatial<span class="error">#</span>,Spatial&gt;&gt;</code></pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-make-procedural-or-custom-shapes">How do I make procedural or custom shapes?</h3>
<div class="paragraph">
<p>You can programmatically create com.jme3.scene.Mesh&#8217;es.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/advanced/custom_meshes.html">Custom Meshes</a></p>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="i-want-to-change-the-surface-of-objects-in-the-scene">I want to change the surface of objects in the scene</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="why-is-my-uv-wrapping-texture-appearance-all-wrong">Why is my UV wrapping / texture appearance all wrong?</h3>
<div class="paragraph">
<p>The most likely reason is the flipping of textures. You may be using the following default method:</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">  material.setTexture(<span class="string"><span class="delimiter">&quot;</span><span class="content">ColorMap</span><span class="delimiter">&quot;</span></span>, assetManager.loadTexture(<span class="string"><span class="delimiter">&quot;</span><span class="content">myTexture.jpg</span><span class="delimiter">&quot;</span></span>));</code></pre>
</div>
</div>
<div class="paragraph">
<p>You can set the boolean value in the constructor of TextureKey to flipped or not flipped. Toggle the boolean to see if it fixes your UV wrapping/texture problem:</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">  material.setTexture(<span class="string"><span class="delimiter">&quot;</span><span class="content">ColorMap</span><span class="delimiter">&quot;</span></span>, <span class="local-variable">this</span>.assetManager.loadTexture(<span class="keyword">new</span> TextureKey(<span class="string"><span class="delimiter">&quot;</span><span class="content">myTexture.jpg</span><span class="delimiter">&quot;</span></span>, <span class="predefined-constant">false</span>)));</code></pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-scale-mirror-or-wrap-a-texture">How do I scale, mirror, or wrap a texture?</h3>
<div class="paragraph">
<p>You cannot scale a texture, but you scale the texture coordinates of the mesh the texture is applied to:</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----mesh.scaleTextureCoordinates(<span class="keyword">new</span> Vector2f(<span class="integer">2</span>,<span class="integer">2</span>));----
You can choose among various <span class="error">`</span>com.jme3.texture.Texture.WrapMode<span class="error">`</span>s <span class="keyword">for</span> individual texture maps of a material: BorderClamp, EdgeClamp, Clamp; MirrorBorderClamp, MirrorEdgeClamp, MirrorClamp; Repeat, MirroredRepeat.</code></pre>
</div>
</div>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----material.getTextureParam(<span class="string"><span class="delimiter">&quot;</span><span class="content">DiffuseMap</span><span class="delimiter">&quot;</span></span>).getTextureValue().setWrap(WrapMode.Repeat);----</code></pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-change-color-or-shininess-of-an-material">How do I change color or shininess of an material?</h3>
<div class="paragraph">
<p>Use the AssetManager to load Materials, and change material settings.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/beginner/hello_material.html">Hello Material</a>, <a href="jme3/intermediate/how_to_use_materials.html">How To Use Materials</a>, <a href="jme3/advanced/materials_overview.html">Materials Overview</a>, <a href="jme3/advanced/asset_manager.html">Asset Manager</a>.</p>
</div>
<div class="paragraph">
<p>+
<strong>Code sample:</strong> <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/material/TestNormalMapping.java">TestNormalMapping.java</a>, <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/model/shape/TestSphere.java">TestSphere.java</a>.</p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-make-a-surface-wood-stone-metal-etc">How do I make a surface wood, stone, metal, etc?</h3>
<div class="paragraph">
<p>Create Textures as image files. Use the AssetManager to load a Material and use texture mapping for improved looks.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/beginner/hello_material.html">Hello Material</a>, <a href="jme3/intermediate/how_to_use_materials.html">How To Use Materials</a>, <a href="jme3/advanced/materials_overview.html">Materials Overview</a>, <a href="jme3/advanced/asset_manager.html">Asset Manager</a>, <a href="http://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/core/com/jme3/asset/AssetManager.java">come.jme3.assets.AssetManager</a>, <a href="http://wiki.blender.org/index.php/Doc:Manual/Textures/Maps/Bump_and_Normal_Maps">Blender: Creating Bump Maps and Normal Maps</a></p>
</div>
<div class="paragraph">
<p>+
<strong>Code sample:</strong> <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/material/TestSimpleBumps.java">TestSimpleBumps.java</a></p>
</div>
</div>
<div class="sect2">
<h3 id="why-are-materials-too-bright-too-dark-or-flickering">Why are materials too bright, too dark, or flickering?</h3>
<div class="paragraph">
<p>If you use a lit material (based on Lighting.j3md) then you must attach a light source to the rootNode, otherwise you see nothing. If you use lit material colors, make sure you have specified an Ambient color (can be the same as the Diffuse color) if you use an AmbientLight. If you see objects, but they are gray or too dark, set the light color to white, or make it brighter (you can multiply the color value with a scalar), or add a global white light source (AmbientLight). Similarly, if everything is too white, tune down the lights. If materials flicker under a directional light, change the light direction vector. Change the background color (which is independent of light sources) to get a better contrast while debugging a light problem.</p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-make-geometries-cast-a-shadow">How do I make geometries cast a shadow?</h3>
<div class="paragraph">
<p>Use com.jme3.shadow.BasicShadowRenderer together with com.jme3.light.DirectionalLight, and setShadowMode().</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/advanced/light_and_shadow.html">Light and Shadow</a></p>
</div>
<div class="paragraph">
<p>+
<strong>Code sample:</strong> <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/effect/TestEverything.java">TestEverything.java</a>, <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/light/TestShadow.java">TestShadow.java</a></p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-make-materials-transparent">How do I make materials transparent?</h3>
<div class="paragraph">
<p>Assign a texture with an alpha channel to a Material and set the Material&#8217;s blend mode to alpha. Use this to create transparent or translucent materials such as glass, window panes, water, tree leaves, etc.</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----material.getAdditionalRenderState().setBlendMode(BlendMode.Alpha);----
*Learn more:*  &lt;&lt;jme3/beginner/hello_material<span class="error">#</span>,Hello Material&gt;&gt;, &lt;&lt;jme3/intermediate/how_to_use_materials<span class="error">#</span>,How To Use Materials&gt;&gt;,</code></pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-force-or-disable-culling">How do I force or disable culling?</h3>
<div class="paragraph">
<p>While debugging custom meshes, you can switch the <code>com.jme3.material.RenderState.FaceCullMode</code> off to see the inside and outside of the mesh.</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----someMaterial.getAdditionalRenderState().setFaceCullMode(FaceCullMode.Off);----
You can also deactivate the <span class="error">`</span>com.jme3.scene.Spatial.CullHint<span class="error">`</span> of a whole spatial to force jme to calculate it even <span class="keyword">if</span> it is behind the camera and outside of view.</code></pre>
</div>
</div>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----someNode.setCullHint(CullHint.Never);----
*Learn more:*  &lt;&lt;jme3/advanced/spatial<span class="error">#</span>,Spatial&gt;&gt;</code></pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="can-i-draw-only-an-outline-of-the-scene">Can I draw only an outline of the scene?</h3>
<div class="paragraph">
<p>Add a renders state to the material&#8217;s and activate <code>Wireframe</code>.</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----material.getAdditionalRenderState().setWireframe(<span class="predefined-constant">true</span>);----
*Learn more:* &lt;&lt;jme3/advanced/debugging<span class="error">#</span>,Debugging&gt;&gt;.</code></pre>
</div>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="i-want-to-control-the-camera">I want to control the camera</h2>
<div class="sectionbody">
<div class="paragraph">
<p>The default camera <code>cam</code> is an instance of the <code>Camera</code> class. <strong>Learn more:</strong> <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-core/src/main/java/com/jme3/renderer/Camera.java">com.jme3.renderer.Camera</a></p>
</div>
<div class="sect2">
<h3 id="how-do-i-keep-the-camera-from-moving">How do I keep the camera from moving?</h3>
<div class="ulist">
<ul>
<li>
<p>SimpleApplication activates <code>flyCam</code> (an instance of <code>FlyByCamera</code>) by default. flyCam causes the camera to move with the mouse and the WASD keys. You can disable flyCam as follows:</p>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----flyCam.setEnabled(<span class="predefined-constant">false</span>);----</code></pre>
</div>
</div>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-switch-between-third-person-and-first-person-view">How do I switch between third-person and first-person view ?</h3>
<div class="ulist">
<ul>
<li>
<p>You can activate the FlyBy Cam as a first-person camera.<br>
<strong>Learn more:</strong> <a href="jme3/beginner/hello_collision.html">Hello Collision</a>.<br>
<strong>Code sample:</strong>  <a href="http://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/core/com/jme3/input/FlyByCam.java">com.jme3.input.FlyByCamera</a></p>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----flyCam.setEnabled(<span class="predefined-constant">true</span>);----</code></pre>
</div>
</div>
</li>
<li>
<p>You can also create a third-person chase cam.<br>
<strong>Learn more:</strong> <a href="http://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/core/com/jme3/input/ChaseCamera.java">com.jme3.input.ChaseCamera</a><br>
<strong>Code sample:</strong> <a href="http://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/test/jme3test/input/TestChaseCamera.java">jme3test/input/TestChaseCamera.java</a>.</p>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----flyCam.setEnabled(<span class="predefined-constant">false</span>);
chaseCam = <span class="keyword">new</span> ChaseCamera(cam, spatial, inputManager);----</code></pre>
</div>
</div>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-increase-camera-speed">How do I increase camera speed?</h3>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----flyCam.setMoveSpeed(<span class="float">50f</span>);----</code></pre>
</div>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="actions-interactions-physics">Actions, Interactions, Physics</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="how-do-i-implement-game-logic-game-mechanics">How do I implement game logic / game mechanics?</h3>
<div class="paragraph">
<p>Use Controls to define the behaviour of types of Spatials. Use Application States to implement global behaviour, to group subsets of input handlers or <abbr title="Graphical User Interface">GUI</abbr> screens, etc. Use the <code>simpleUpdate()</code> and <code>update()</code> loops for tests and interactions. Use Cinematics to remote-control objects in scenes.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/beginner/hello_main_event_loop.html">Hello Loop</a>, <a href="jme3/advanced/update_loop.html">Update Loop</a>, <a href="jme3/advanced/custom_controls.html">Custom Controls</a>, <a href="jme3/advanced/application_states.html">Application States</a>, <a href="jme3/advanced/cinematics.html">Cinematics</a></p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-let-players-interact-via-keyboard">How do I let players interact via keyboard?</h3>
<div class="paragraph">
<p>Use com.jme3.input.KeyInput and a Input Listener.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/beginner/hello_input_system.html">Hello Input</a>, <a href="jme3/advanced/input_handling.html">Input Handling</a></p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-let-players-interact-by-clicking">How do I let players interact by clicking?</h3>
<div class="paragraph">
<p>Players typically click the mouse to pick up objects, to open doors, to shoot a weapon, etc. Use an Input Listener to respond to mouse clicks, then cast a ray from the player; if it intersects with the bounding volume of a spatial, this is the selected target. The links below contain code samples for both “fixed crosshair picking and “free mouse pointer picking.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/beginner/hello_picking.html">Hello Picking</a>, <a href="jme3/advanced/mouse_picking.html">Mouse Picking</a>, <a href="jme3/advanced/collision_and_intersection.html">Collision and Intersection</a>, <a href="jme3/advanced/input_handling.html">Input Handling</a>, com.jme3.bounding.*, com.jme3.math.Ray, com.jme3.collision.CollisionResults.</p>
</div>
<div class="paragraph">
<p>+
<strong>Code sample:</strong> <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/bounding/TestRayCollision.java">TestRayCollision.java</a></p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-animate-characters">How do I animate characters?</h3>
<div class="paragraph">
<p>Create an animated OgreMesh model with bones in a 3-D mesh editor (e.g. Blender).</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> com.jme3.animation.*, <a href="jme3/beginner/hello_animation.html">Hello Animation</a>, <a href="jme3/advanced/animation.html">Animation</a>, <a href="http://wiki.blender.org/index.php/Doc:Tutorials/Animation/BSoD/Character_Animation">Blender animation tutorial</a></p>
</div>
<div class="paragraph">
<p>+
<strong>Code sample:</strong>  <a href="https://github.com/jMonkeyEngine/jmonkeyengine/tree/master/jme3-examples/src/main/java/jme3test/model/anim">animation</a></p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-keep-players-from-falling-through-walls-and-floors">How do I keep players from falling through walls and floors?</h3>
<div class="paragraph">
<p>Use collision detection. The most common solution is to use jme&#8217;s physics integration, jBullet.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/beginner/hello_collision.html">Hello Collision</a>, <a href="jme3/advanced/physics.html">Physics</a>, com.jme3.bullet.*, CapsuleCollisionShape versus CompoundCollisionShape, CharacterControl versus RigidBodyControl.</p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-make-balls-wheels-etc-bounce-and-roll">How do I make balls/wheels/etc bounce and roll?</h3>
<div class="paragraph">
<p>Add physics controls to Spatials and give them spherical or cylindrical bounding volumes.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/beginner/hello_physics.html">Hello Physics</a>, <a href="jme3/advanced/physics.html">Physics</a>, com.jme3.bounding.*, com.jme3.bullet.collisions, com.jme3.bullet.controls.RigidBodyControl,</p>
</div>
<div class="paragraph">
<p>+
<strong>Code sample:</strong> <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/bullet/TestSimplePhysics.java">TestSimplePhysics.java</a>, <a href="https://github.com/jMonkeyEngine/jmonkeyengine/tree/master/jme3-examples/src/main/java/jme3test/bullet">more physics samples</a></p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-debug-weird-physics-behaviour">How do I debug weird Physics behaviour?</h3>
<div class="paragraph">
<p>Maybe your collision shapes overlap – or they are not where you think they are. Make the collision shapes visible by adding the following line after the bulletAppState initialization:</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----bulletAppState.getPhysicsSpace().enableDebug(assetManager);----</code></pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-make-a-walking-character">How do I make a walking character?</h3>
<div class="paragraph">
<p>You can use jBullet&#8217;s CharacterControl that locks a physical object upright, so it does not tip over when moving/walking (as tall physical objects are typically wanted to).</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> CharacterControl</p>
</div>
<div class="paragraph">
<p>+
Code samples: <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/bullet/TestQ3.java">TestQ3.java</a> (first-person), <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/bullet/TestPhysicsCharacter.java">TestPhysicsCharacter.java</a> (third-person)</p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-steer-vehicles">How do I steer vehicles?</h3>
<div class="paragraph">
<p>Use a VehicleControl that supports suspension behavior.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/advanced/vehicles.html">Vehicles</a>, com.jme3.bullet.*, VehicleControl</p>
</div>
<div class="paragraph">
<p>+
Code samples: <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/bullet/TestFancyCar.java">TestFancyCar.java</a>, (Press HUJK keys to steer, spacebar to jump.)</p>
</div>
</div>
<div class="sect2">
<h3 id="can-objects-swing-like-a-pendulums-chains-ropebridges">Can objects swing like a pendulums, chains, ropebridges?</h3>
<div class="paragraph">
<p>Use a PhysicsControl&#8217;s hinges and joints.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/advanced/hinges_and_joints.html">Hinges and Joints</a>, com.jme3.bullet.joints.PhysicsHingeJoint,
<a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/bullet/TestPhysicsHingeJoint.java">TestPhysicsHingeJoint.java</a> (Press HK keys to turn, spacebar to swing.)</p>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="default-gui-display">Default GUI Display</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="what-are-these-fps-objects-vertices-triangles-statistics">What are these FPS/Objects/Vertices/Triangles statistics?</h3>
<div class="paragraph">
<p>At the bottom left of every default SimpleGame, you see the <a href="jme3/advanced/statsview.html">StatsView</a> and the FPS (frames per seconds) view. These views provide you with extra information during the development phase. For example, if you notice the object count is increasing and the FPS is decreasing, then you know that your code attaches too many objects and does not detach enough of them again (maybe a loop gone wild?).</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/advanced/statsview.html">StatsView</a></p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-get-rid-of-the-fps-objects-statistics">How do I get rid of the FPS/Objects statistics?</h3>
<div class="paragraph">
<p>In the application&#8217;s simpleInitApp() method, call:</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code>----setDisplayFps(false); // to hide the FPS
setDisplayStatView(false); // to hide the statistics ----</code></pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-display-score-health-mini-maps-status-icons">How do I display score, health, mini-maps, status icons?</h3>
<div class="paragraph">
<p>Attach text and pictures to the orthogonal <code>guiNode</code> to create a heads-up display (<a href="http://en.wikipedia.org/wiki/HUD_%28video_gaming%29">HUD</a>).</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/advanced/hud.html">HUD</a>, com.jme3.font.*, com.jme3.ui.Picture, guiNode.attachChild()</p>
</div>
<div class="paragraph">
<p>+
<strong>Code sample:</strong> <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/gui/TestOrtho.java">TestOrtho.java</a>,
<a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/gui/TestBitmapFont.java">TestBitmapFont.java</a> |</p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-display-buttons-and-ui-controls">How do I display buttons and UI controls?</h3>
<div class="paragraph">
<p>You may want to display buttons to let the player switch between the game, settings screen, and score screens. For buttons and other more advanced UI controls, jME supports the Nifty <abbr title="Graphical User Interface">GUI</abbr> library.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/advanced/nifty_gui.html">Nifty GUI</a></p>
</div>
<div class="paragraph">
<p>+
Sample Code: <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/niftygui/TestNiftyGui.java">TestNiftyGui.java</a></p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-display-a-loading-screen">How do i display a loading screen?</h3>
<div class="paragraph">
<p>Instead of having a frozen frame while your games loads, you can have a loading screen while it loads.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/advanced/loading_screen.html">Loading screen</a></p>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="nifty-gui">Nifty GUI</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="i-get-nosuchelementexception-when-adding-controls-buttons-etc">I get NoSuchElementException when adding controls (buttons etc)!</h3>
<div class="paragraph">
<p>Verify that you include a controls definition file link in your XML: This is the default:</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="xml">----<span class="tag">&lt;useControls</span> <span class="attribute-name">filename</span>=<span class="string"><span class="delimiter">&quot;</span><span class="content">nifty-default-controls.xml</span><span class="delimiter">&quot;</span></span><span class="tag">/&gt;</span>----</code></pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="where-can-i-find-example-code-of-nifty-gui-s-xml-and-java-classes">Where can I find example code of Nifty GUI&#8217;s XML and Java classes?</h3>
<div class="paragraph">
<p><a href="http://nifty-gui.svn.sourceforge.net/viewvc/nifty-gui/nifty-examples/trunk/src/main/">http://nifty-gui.svn.sourceforge.net/viewvc/nifty-gui/nifty-examples/trunk/src/main/</a></p>
</div>
</div>
<div class="sect2">
<h3 id="is-there-java-doc-for-nifty-gui">Is there Java Doc for Nifty GUI?</h3>
<div class="paragraph">
<p><a href="jme3/advanced/nifty_gui_java_interaction.html#useful_links">Nifty GUI 1.3 Java docs</a></p>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="i-want-to-create-an-environment-with-sounds-effects-and-landscapes">I want to create an environment with sounds, effects, and landscapes</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="how-do-i-play-sounds-and-noises">How do I play sounds and noises?</h3>
<div class="paragraph">
<p>Use AudioRenderer, Listener, and AudioNode from com.jme3.audio.*.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/beginner/hello_audio.html">Hello Audio</a>, <a href="jme3/advanced/audio.html">Audio</a></p>
</div>
<div class="paragraph">
<p>+
<strong>Code sample:</strong> <a href="https://github.com/jMonkeyEngine/jmonkeyengine/tree/master/jme3-examples/src/main/java/jme3test/audio">audio</a></p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-make-fire-smoke-explosions-swarms-magic-spells">How do I make fire, smoke, explosions, swarms, magic spells?</h3>
<div class="paragraph">
<p>For swarm like effects you use particle emitters.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/beginner/hello_effects.html">Hello Effects</a>, <a href="jme3/advanced/particle_emitters.html">Particle Emitters</a>, <a href="jme3/advanced/bloom_and_glow.html">Bloom and Glow</a>, <a href="jme3/advanced/effects_overview.html">Effects Overview</a>, com.jme3.effect.EmitterSphereShape, com.jme3.effect.ParticleEmitter</p>
</div>
<div class="paragraph">
<p>+
<strong>Code sample:</strong> <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/effect/TestExplosionEffect.java">TestExplosionEffect.java</a>,
<a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/effect/TestMovingParticle.java">TestMovingParticle.java</a>,
<a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/effect/TestSoftParticles.java">TestSoftParticle.java</a></p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-make-water-waves-reflections">How do I make water, waves, reflections?</h3>
<div class="paragraph">
<p>Use a special post-processor renderer from com.jme3.water.*.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/advanced/water.html">Water</a>, <a href="jme3/advanced/post-processor_water.html">Post-Processor Water</a></p>
</div>
<div class="paragraph">
<p>+
<strong>Code sample:</strong> <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/water/TestSimpleWater.java">TestSimpleWater.java</a>, <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/water/TestSceneWater.java">TestSceneWater.java</a>, <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/water/TestPostWaterLake.java">TestPostWaterLake.java</a>, <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/water/TestPostWater.java">TestPostWater.java</a></p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-make-fog-bloom-blur-light-scattering">How do I make fog, bloom, blur, light scattering?</h3>
<div class="paragraph">
<p>Use special post-processor renderers from com.jme3.post.*.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/advanced/effects_overview.html">effects_overview</a></p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-generate-a-terrain">How do I generate a terrain?</h3>
<div class="paragraph">
<p>Use com.jme3.terrain.*. The JMonkeyEngine also provides you with a Terrain Editor plugin.</p>
</div>
<div class="paragraph">
<p>+
<strong>Learn more:</strong> <a href="jme3/beginner/hello_terrain.html">Hello Terrain</a>, <a href="jme3/advanced/terrain.html">Terrain</a>, <a href="sdk/terrain_editor.html">Terrain Editor</a></p>
</div>
<div class="paragraph">
<p>+
<strong>Code sample:</strong> <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/terrain/TerrainTest.java">TerrainTest.java</a></p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-make-a-sky">How do I make a sky?</h3>
<div class="paragraph">
<p><strong>Code sample:</strong> <a href="https://github.com/jMonkeyEngine/jmonkeyengine/blob/master/jme3-examples/src/main/java/jme3test/texture/TestSkyLoading.java">TestSkyLoading.java</a></p>
</div>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----rootNode.attachChild(SkyFactory.createSky( assetManager,
       <span class="string"><span class="delimiter">&quot;</span><span class="content">Textures/Sky/Bright/BrightSky.dds</span><span class="delimiter">&quot;</span></span>, <span class="predefined-constant">false</span>));
skyGeo.setQueueBucket(Bucket.Sky) ----
*Learn more:* &lt;&lt;jme3/advanced/sky<span class="error">#</span>,Sky&gt;&gt;</code></pre>
</div>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="i-want-to-access-to-back-end-properties">I want to access to back-end properties</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="how-do-i-read-out-graphic-card-capabilities">How do I read out graphic card capabilities?</h3>
<div class="paragraph">
<p>If your game is heavily using features that older cards do not support, you can <a href="jme3/advanced/read_graphic_card_capabilites.html">Read Graphic Card Capabilites</a> in the beginning before starting the app, and then decide how to proceed.</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----<span class="predefined-type">Collection</span>&lt;com.jme3.renderer.Caps&gt; caps = renderer.getCaps();
<span class="predefined-type">Logger</span>.getLogger(HelloJME3.class.getName()).log(<span class="predefined-type">Level</span>.INFO, <span class="string"><span class="delimiter">&quot;</span><span class="content">Capabilities: {0}</span><span class="delimiter">&quot;</span></span>, caps.toString());----</code></pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-run-jmonkeyengine-3-with-opengl1">How do I Run jMonkeyEngine 3 with OpenGL1?</h3>
<div class="paragraph">
<p>In your game, add</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----settings.setRenderer(AppSettings.LWJGL_OPENGL1)----
 to the &lt;&lt;jme3/intermediate/appsettings<span class="error">#</span>,AppSettings&gt;&gt; (see details there). +</code></pre>
</div>
</div>
<div class="paragraph">
<p>For the jMonkeyEngine SDK itself, choose Options &gt; OpenGL, and check OpenGL1.</p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-optimize-the-heck-out-of-the-scene-graph">How do I optimize the heck out of the Scene Graph?</h3>
<div class="paragraph">
<p>You can batch all Geometries in a scene (or a subnode) that remains static.</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="CodeRay highlight"><code data-lang="java">----jme3tools.optimize.GeometryBatchFactory.optimize(rootNode);----
Batching means that all Geometries with the same Material are combined into one mesh. This optimization only has an effect <span class="keyword">if</span> you use only few (roughly up to <span class="integer">32</span>) Materials total. The pay-off is that batching takes extra time when the game is initialized.</code></pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-prevent-users-from-unzipping-my-jar">How do I prevent users from unzipping my JAR?</h3>
<div class="paragraph">
<p>Add an <a href="http://netbeans.dzone.com/tips/obfuscating-netbeans-java-appl">obfuscator to the Ant script</a>. The SDK comes with a basic obfuscation script that you can enable in the project settings.</p>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="i-want-to-do-maths">I want to do maths</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="what-does-addlocal-multlocal-etc-mean">What does addLocal() / multLocal() etc mean?</h3>
<div class="paragraph">
<p>Many maths functions (mult(), add(), subtract(), etc) come as local and a non-local variant (multLocal(), addLocal(), subtractLocal(), etc).</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Non-local means a new independent object is created (similar to clone()) as a return value. Use non-local methods if you want to keep using the old value of the object calling the method.</p>
<div class="ulist">
<ul>
<li>
<p>Example 1:  <code>Quaternion q1 = q2.mult(q3);</code></p>
<div class="ulist">
<ul>
<li>
<p>Returns the result as a new Quaternion q1.</p>
</li>
<li>
<p>The involved objects q2 and q3 stay as they are and can be reused.</p>
</li>
</ul>
</div>
</li>
<li>
<p>Example 2: <code>v.mult(b).add(b);</code> emoji:</p>
<div class="ulist">
<ul>
<li>
<p><strong>Watch out:</strong> This calculates the expected result, but unless you actually use the return value, it is discarded!</p>
</li>
</ul>
</div>
</li>
</ul>
</div>
</li>
<li>
<p>Local means that no new objects are created, instead, the calling object is modified. Use this if you are sure you no longer need the old value of the calling object.</p>
<div class="ulist">
<ul>
<li>
<p>Example 1: <code>q2.multLocal(q3)</code></p>
<div class="ulist">
<ul>
<li>
<p>Calculates q2*q3 without creating temp objects.</p>
</li>
<li>
<p>The result is stored in the calling object q2. The old value of q2 is gone.</p>
</li>
<li>
<p>Object q3 stays as it was.</p>
</li>
</ul>
</div>
</li>
<li>
<p>Example 2:`v.multLocal(a).addLocal(b);`</p>
<div class="ulist">
<ul>
<li>
<p>Calculates the expected result without creating temp objects.</p>
</li>
<li>
<p>The result is stored in the calling object v. The old value of v is gone.</p>
</li>
<li>
<p>The objects a and b stay as they were.</p>
</li>
</ul>
</div>
</li>
</ul>
</div>
</li>
</ol>
</div>
</div>
<div class="sect2">
<h3 id="what-is-the-difference-between-world-and-local-coordinates">What is the difference between World and Local coordinates?</h3>
<div class="paragraph">
<p>World coordinates of a Spatial are its absolute coordinates in the 3D scene (this is like giving GPS coordinates). Local coordinates are relative to the Spatial&#8217;s parent Spatial (this is like saying, “I&#8217;m ten meters left of the entrance).</p>
</div>
</div>
<div class="sect2">
<h3 id="how-do-i-convert-degrees-to-radians">How do I convert Degrees to Radians?</h3>
<div class="paragraph">
<p>Multiply degree value by FastMath.DEG_TO_RAD to convert it to radians.</p>
</div>
<div class="paragraph">
<p>&lt;tags&gt;&lt;tag target="documentation" /&gt;&lt;tag target="faq" /&gt;&lt;/tags&gt;</p>
</div>
</div>
</div>
</div>
</div>
<div id="footer">
<div id="footer-text">
Last updated 2016-05-21 23:44:18 UTC
</div>
</div>
</body>
</html>