{"id":239,"date":"2016-02-15T16:39:02","date_gmt":"2016-02-15T16:39:02","guid":{"rendered":"http:\/\/fractorium.com\/?page_id=239"},"modified":"2019-06-04T00:13:33","modified_gmt":"2019-06-04T00:13:33","slug":"getting-started","status":"publish","type":"page","link":"http:\/\/fractorium.com\/?page_id=239","title":{"rendered":"Getting started"},"content":{"rendered":"<p>Below is a list of prerequisites you must meet and steps you must take to\u00a0get Fractorium installed and running on\u00a0your system.<\/p>\n<h3 class=\"collapseomatic \" id=\"id69fb112e82a5a\"  tabindex=\"0\"     >OS<\/h3><div id=\"target-id69fb112e82a5a\" class=\"collapseomatic_content \">\n<p>Fractorium is available only as a 64-bit program, which means it needs a 64-bit operating system to run. For Windows, this means\u00a0Windows 7 or later. For Linux, this means recent versions of Ubuntu x64, such as <a href=\"https:\/\/linuxmint.com\/\" target=\"_blank\" rel=\"noopener\">Mint<\/a>.<\/p>\n<p>Although not officially supported, some users have reported success on debian by following these steps:<\/p>\n<ul>\n<li>When compiling from source, make sure there is no conflicting previously installed version.<\/li>\n<li>Make sure you fully install it using <code>sudo make install<\/code>. You may not run it in place.<\/li>\n<li>You must have OpenCL 1.2 or later installed. At the time of this writing, Mesa\/Clover goes to 1.1 only.<\/li>\n<li>To install OpenCL 1.2 on an OS which does not have it pre-installed, follow these steps:\n<ul>\n<li><a href=\"https:\/\/github.com\/RadeonOpenCompute\/ROCm#first-make-sure-your-system-is-up-to-date\" target=\"_blank\" rel=\"noopener\">https:\/\/github.com\/RadeonOpenCompute\/ROCm#first-make-sure-your-system-is-up-to-date<\/a><\/li>\n<li><a href=\"https:\/\/github.com\/RadeonOpenCompute\/ROCm#add-the-rocm-apt-repository\" target=\"_blank\" rel=\"noopener\">https:\/\/github.com\/RadeonOpenCompute\/ROCm#add-the-rocm-apt-repository<\/a><\/li>\n<li><a href=\"https:\/\/github.com\/RadeonOpenCompute\/ROCm#using-debian-based-rocm-with-upstream-kernel-drivers\" target=\"_blank\" rel=\"noopener\">https:\/\/github.com\/RadeonOpenCompute\/ROCm#using-debian-based-rocm-with-upstream-kernel-drivers<\/a><\/li>\n<li>You may need to <code>sudo apt purge mesa-opencl-icd pocl-opencl-icd<\/code> to remove unwanted platforms that confuse the OpenCL loader system. Use <code>clinfo<\/code> from the command line to check for a successful installation. If so, you should see AMD-APP in the Platform Version.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/div>\n<h3 class=\"collapseomatic \" id=\"id69fb112e82c38\"  tabindex=\"0\"     >Hardware<\/h3><div id=\"target-id69fb112e82c38\" class=\"collapseomatic_content \">\n<p>Using the GPU to render is only supported on GCN or later AMD cards and Fermi or later Nvidia cards. If you do not have one of these, you can still run the program, but all processing will be done on the CPU. While not as fast as using a GPU, the CPU is still reasonably fast.<\/p>\n<p>Intel HD grahics are not supported as a GPU device.<\/p>\n<\/div>\n<h3 class=\"collapseomatic \" id=\"id69fb112e82d0e\"  tabindex=\"0\"     >Drivers<\/h3><div id=\"target-id69fb112e82d0e\" class=\"collapseomatic_content \">\n<p>Fractorium makes use of special features on your\u00a0graphics card, so before installing you need to ensure your drivers are up to date.<\/p>\n<h4>AMD and Nvidia users<\/h4>\n<p style=\"padding-left: 30px;\">Before installing Fractorium, go to the website for your graphics card manufacturer, download and install the latest drivers.<\/p>\n<h4>Non-AMD or Nvidia users<\/h4>\n<p style=\"padding-left: 30px;\">Intel makes a dummy driver for systems without sufficient hardware which is needed for the program to run.<\/p>\n<p style=\"padding-left: 30px;\">If you&#8217;ve already installed the latest drivers and still\u00a0get a message saying that OpenCL.dll is missing from your system, it means your hardware is unsupported. In that case, download and install\u00a0one of the top two drivers on <a href=\"https:\/\/downloadcenter.intel.com\/product\/81493\/Intel-Iris-Pro-Graphics-5200-for-4th-Generation-Intel-Core-Processors\">this<\/a>\u00a0page, depending on your OS.<\/p>\n<\/div>\n<h3 class=\"collapseomatic \" id=\"id69fb112e82dde\"  tabindex=\"0\"     >Installation<\/h3><div id=\"target-id69fb112e82dde\" class=\"collapseomatic_content \">\n<p>Install Fractorium using the installer which will place all files needed to run in\u00a0<code>C:\\Users\\[user]\\AppData\\Roaming\\Fractorium<\/code><\/p>\n<p>In addition to the executable, the palette file, settings file and a sample theme file all reside here.<\/p>\n<\/div>\n<h3 class=\"collapseomatic \" id=\"id69fb112e82ed6\"  tabindex=\"0\"     >First Run<\/h3><div id=\"target-id69fb112e82ed6\" class=\"collapseomatic_content \">\n<p>Run the program from the shortcut created on the desktop.<\/p>\n<p>The default configuration on the first run is to use the CPU. If it starts up with no errors and shows a randomly generated flame in the main window, then installation was successful.<\/p>\n<\/div>\n<h3 class=\"collapseomatic \" id=\"id69fb112e82fb3\"  tabindex=\"0\"     >Enabling the GPU<\/h3><div id=\"target-id69fb112e82fb3\" class=\"collapseomatic_content \">\n<p>Open the <a href=\"http:\/\/fractorium.com\/?page_id=999\" target=\"_blank\" rel=\"noopener\">Options dialog<\/a>\u00a0to\u00a0see if any available GPU hardware is listed. If so, check <code>Use OpenCL<\/code> and <code>Shared Texture<\/code> and select the GPUs you want to use from the list by checking <code>Use<\/code>. You must set\u00a0the one connected to the display as the primary. Do not use an iGPU if one is present, they are unsupported. Also do not combine devices using a CPU and GPU. It offers no performance gain and is not supported. So run with one or the other.<\/p>\n<p>Click <code>Ok<\/code> to accept the new settings and dismiss the dialog.<\/p>\n<p>After a short pause, if the render completes without any warnings then your GPU is of sufficient capability to be used for rendering. Restart the program to ensure these settings save.<\/p>\n<p>If any errors were encountered, try again, but uncheck <code>Shared Texture<\/code>. Click <code>Ok<\/code> to accept the new settings and dismiss the dialog.<\/p>\n<p>If any errors were\u00a0encountered, then you must only use the CPU.<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Below is a list of prerequisites you must meet and steps you must take to\u00a0get Fractorium installed and running on\u00a0your system.<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":57,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-239","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"http:\/\/fractorium.com\/index.php?rest_route=\/wp\/v2\/pages\/239","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/fractorium.com\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"http:\/\/fractorium.com\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"http:\/\/fractorium.com\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"http:\/\/fractorium.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=239"}],"version-history":[{"count":38,"href":"http:\/\/fractorium.com\/index.php?rest_route=\/wp\/v2\/pages\/239\/revisions"}],"predecessor-version":[{"id":2191,"href":"http:\/\/fractorium.com\/index.php?rest_route=\/wp\/v2\/pages\/239\/revisions\/2191"}],"up":[{"embeddable":true,"href":"http:\/\/fractorium.com\/index.php?rest_route=\/wp\/v2\/pages\/57"}],"wp:attachment":[{"href":"http:\/\/fractorium.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=239"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}