VERY experimental Nintendo Switch 2 emulator
C++
[docs] troubleshoot section, release policies, gpu documentation (#3078)
lizzie1e06c6f752c3
diff --git a/.reuse/dep5 b/.reuse/dep5index b02784b829..081c21e583 100644--- a/.reuse/dep5+++ b/.reuse/dep5@@ -13,8 +13,6 @@ Copyright: yuzu Emulator ProjectLicense: GPL-2.0-or-laterFiles: dist/qt_themes/default/icons/256x256/eden.png- dist/qt_themes/default/icons/256x256/eden_named.png- dist/Assets.cardist/yuzu.bmpdist/eden.icnsdist/eden.icodiff --git a/CMakeLists.txt b/CMakeLists.txtindex ea0bbe2423..c9b0071f64 100644--- a/CMakeLists.txt+++ b/CMakeLists.txt@@ -26,8 +26,9 @@ endif()# Needed for FFmpeg w/ VAAPI and DRMif (PLATFORM_OPENBSD)- set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -I${CMAKE_SYSROOT}/usr/X11R6/include")- set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -I${CMAKE_SYSROOT}/usr/X11R6/include")+ # OpenBSD 7.8 broke libcxx when upgrading, so we must define the PSTL backend manually+ set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -I${CMAKE_SYSROOT}/usr/X11R6/include -D_LIBCPP_PSTL_BACKEND_SERIAL=1")+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -I${CMAKE_SYSROOT}/usr/X11R6/include -D_LIBCPP_PSTL_BACKEND_SERIAL=1")set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -L${CMAKE_SYSROOT}/usr/X11R6/lib")elseif (PLATFORM_NETBSD)set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -I${CMAKE_SYSROOT}/usr/X11R7/include")diff --git a/dist/eden_named.svg b/dist/eden_named.svgdeleted file mode 100644index 127bd05ae1..0000000000--- a/dist/eden_named.svg+++ /dev/null@@ -1,81 +0,0 @@-<?xml version="1.0" encoding="UTF-8" standalone="no"?>-<svg- width="512"- height="512"- fill="none"- viewBox="0 0 512 512"- version="1.1"- id="svg7"- sodipodi:docname="base_named.svg"- inkscape:version="1.4.2 (ebf0e940d0, 2025-05-08)"- xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"- xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"- xmlns="http://www.w3.org/2000/svg"- xmlns:svg="http://www.w3.org/2000/svg">- <defs- id="defs7">- <filter- inkscape:collect="always"- style="color-interpolation-filters:sRGB"- id="filter7"- x="-0.020030975"- y="-0.059239059"- width="1.0401226"- height="1.1184926">- <feGaussianBlur- inkscape:collect="always"- stdDeviation="1.0704714"- id="feGaussianBlur7" />- </filter>- </defs>- <sodipodi:namedview- id="namedview7"- pagecolor="#ffffff"- bordercolor="#000000"- borderopacity="0.25"- inkscape:showpageshadow="2"- inkscape:pageopacity="0.0"- inkscape:pagecheckerboard="0"- inkscape:deskcolor="#d1d1d1"- inkscape:zoom="1.25"- inkscape:cx="256"- inkscape:cy="256"- inkscape:window-width="1600"- inkscape:window-height="849"- inkscape:window-x="0"- inkscape:window-y="27"- inkscape:window-maximized="1"- inkscape:current-layer="svg7" />- <path- fill="#bf42f6"- d="M346.71 255.306c.788.006 1.577.013 3.124.059 4.006.027 7.253.015 10.501.003 33.391.022 66.783.028 100.175.078 8.174.013 16.349.279 24.522.209 3.084-.026 4.596.75 4.356 4.156-.293 4.157-.31 8.343-.259 12.513.049 3.964-1.248 5.539-5.679 5.524-48.85-.158-97.701-.071-146.552-.056-22.107.007-44.214 0-66.321 0h-5.43v7.117h223.011c-1.553 8.254-2.894 15.76-4.475 23.215-.17.802-1.666 1.617-2.685 1.87-1.312.327-2.763.099-4.155.099H265.099v6.701h216.666c-1.609 5.425-2.887 10.074-4.367 14.658-2.758 8.54-2.807 8.524-11.564 8.524-64.929 0-129.859.014-194.788-.04-3.401-.003-6.19.251-4.758 4.652.349 1.075 1.875 2.026 3.071 2.491 1.075.418 2.439.092 3.676.092l191.542.001h7.17c-3.533 7.29-6.399 13.72-9.834 19.83-.651 1.157-3.562 1.448-5.432 1.454-27.981.088-55.963.061-83.944.061-31.692 0-63.384.005-95.075-.008-2.61-.002-5.219-.124-8.53-.021-3.11.173-5.518.177-7.926.181-.849-7.032-2.289-14.051-2.44-21.098-.547-25.616-.773-51.242-.844-76.864-.014-4.88 1.228-9.763 2.52-14.927 2.88-.296 5.132-.31 7.81-.259 22.492.021 44.557-.024 67.034-.066 4.149-.049 7.886-.099 11.624-.149"- id="path1" />- <path- fill="#ff44c4"- d="M168.124 257.114v-9.301c-2.407 0-4.67-.001-6.933.001-44.522.025-89.044.01-133.566.146-3.858.012-5.358-1.03-4.744-5 .683-4.418 1.254-8.885 1.393-13.346.106-3.386 1.603-4.005 4.608-4.012 45.9-.11 91.801-.344 137.702-.452 3.865-.009 6.842-.344 6.032-5.831H25.546c1.39-6.599 2.354-12.681 4.138-18.513.413-1.35 3.628-2.615 5.555-2.618 47.458-.084 94.917-.01 142.375.109 3.275.008 5.855-.38 6.138-5.045H31.147c3.43-9.311 6.348-17.71 9.74-25.913.483-1.166 3.265-1.942 4.987-1.95 24.582-.124 49.165-.21 73.745.014 5.283.048 8.073-2.583 11.128-7.248h-86.45c4.35-7.835 8.002-14.753 12.077-21.412.67-1.096 3.197-1.473 4.868-1.478 30.611-.083 61.226-.291 91.832.113 7.185.094 12.719-2.619 18.321-6.774H61.385c2.592-3.805 4.355-6.546 6.268-9.178 8.88-12.216 8.896-12.209 24.069-12.21q60.991-.002 121.982-.001h5.885c-3.968-4.128-7.007-6.966-12.321-6.944-38.959.165-77.92.09-116.88.09H85.03l-.741-1.31c3.832-3.852 7.564-7.81 11.514-11.537 11.456-10.807 11.495-10.996 27.246-10.717 23.209.411 45.103 6.8 66.234 15.885 5.657 2.432 10.56 3.715 16.604.944 4.726-2.166 10.217-2.664 16.034-3.521-4.411 8.139.887 12.041 5.52 16.414 5.73 5.408 11.223 11.07 16.751 16.688 1.165 1.185 2.035 2.659 3.685 4.857-2.256.128-3.665.274-5.075.275-9.739.008-19.489.286-29.214-.085-28.045-1.07-51.592 9.244-71.602 28.209-7.152 6.778-13.525 14.379-20.212 21.643-.683.742-1.079 1.748-2.209 3.632 33.94-11.926 65.876-27.377 101.589-28.637l.859 1.395c-4.228 4.943-8.188 10.148-12.73 14.783-18.091 18.461-28.905 40.673-33.892 65.773-1.402 7.057-1.306 14.412-2.504 21.941-1.992.248-3.377.184-4.762.121m19.995-91.726c3.865.004 7.763-.315 11.585.09 5.562.589 8.92-2.178 12.525-7.52-9.134 2.152-17.144 4.039-25.139 5.988-.008.002.209.928 1.029 1.442"- id="path2" />- <path- fill="#bf43f5"- d="M167.719 257.136c1.79.041 3.175.105 4.979.185.569 3.091.719 6.166.87 9.24l1.623.577c2.3-3.392 4.599-6.785 7.467-10.458 2.456-.382 4.343-.483 6.573-.598 1.405-.133 2.466-.342 3.53-.356 12.08-.162 24.16-.295 36.693-.368 3.463.111 6.473.155 9.484.2-1.12 6.677-2.306 13.345-3.347 20.035-4.715 30.285-5.404 60.697-3.186 91.651-2.469.746-4.517 1.048-6.565 1.35-56.117-.025-112.236-.135-168.353.061-5.334.018-8.298-1.559-10.185-6.415-1.874-4.824-4.295-9.436-6.907-15.069h17.147c53.955 0 107.909.013 161.863-.044 2.026-.002 4.864 1.218 5.327-2.599.469-3.862-1.271-4.625-4.781-4.616-38.803.103-77.607.061-116.411.068-20.405.003-40.811-.065-61.215.125-3.545.033-5.36-1.044-6.324-4.419-1.642-5.75-3.577-11.416-5.879-18.659 65.363-.259 129.677-.027 194.424-.144l.372-6.533c-1.901-.099-3.398-.244-4.896-.245-58.283-.032-116.565-.056-174.848-.06-4.48 0-8.964.279-13.439.163-1.138-.029-3.078-.897-3.247-1.681-1.676-7.766-3.056-15.595-4.624-23.961 8.433 0 15.808-.031 23.182.02 1.998.014 3.995.4 5.992.401 55.964.023 111.928.02 167.892.017 6.075 0 6.307-.256 6.266-7.198H23.431c-.284-6.643-.72-12.739-.592-18.823.016-.786 2.94-2.144 4.53-2.165 15.149-.197 30.3-.177 45.45-.191 17.623-.016 35.248-.072 52.871.018 13.876.07 27.75.335 42.029.491"- id="path3" />- <path- fill="#985ded"- d="M225.868 369.021c2.02-.729 4.068-1.031 6.551-1.351 2.672 17.851 4.169 35.853 7.334 53.556 4.047 22.64 9.785 44.94 18.63 66.298.29.699.498 1.433.742 2.142-25.39 10.452-124.622-22.609-146.929-49.453h122.669c.302-4.81-.85-6.915-5.85-6.891-39.883.193-79.768.055-119.652.182-4.441.014-8.036-.845-11.208-4.17-6.87-7.203-13.99-14.166-21.008-21.228l.69-1.319H229.63l-1.24-7.289h-5.726c-42.821 0-85.642.011-128.464-.013-6.18-.003-12.371-.428-18.537-.173-3.704.154-6.14-1.066-8.104-4.073-4.111-6.292-8.367-12.489-13.256-19.755h171.593c0-2.433 0-4.234-.027-6.463m35.103.062c2.442-.418 4.85-.422 7.641-.431.482 1.987.581 3.979.706 6.499H457.62c-3.126 4.951-5.544 8.946-8.123 12.835-7.64 11.521-7.665 11.508-21.226 11.509l-147.5.003h-5.407c-.602 6.688-.15 7.214 5.824 7.214q73.75.004 147.5.004h6.891c-4.048 4.533-7.454 7.812-10.233 11.556-9.047 12.19-20.575 16.124-35.967 15.542-33.039-1.25-66.159-.384-99.246-.384h-5.45c-.275 5.77.583 6.774 5.594 6.776 34.478.012 68.957.006 103.435.007h5.302l.443 1.274c-3.495 2.62-6.91 5.358-10.5 7.842-23.505 16.265-49.192 27.744-76.893 34.696-3.263.819-6.763 1.374-10.069 1.085-1.874-.164-4.144-1.915-5.266-3.597-9.503-14.258-15.474-30.133-21.055-46.227-7.418-21.394-11.59-43.465-14.702-66.203"- id="path4" />- <path- fill="#ff43c4"- d="M360.319 254.985c-3.232.395-6.479.407-10.189.359 2.612-14.328 2.295-28.523-1.162-42.703-4.74-19.439-15.808-34.254-32.502-45.039-.639-.413-1.27-.839-1.852-2.137h52.547l.213-1.506c-7.026-2.665-13.978-5.752-21.733-5.819-15.455-.136-30.914.047-46.369-.12-3.092-.034-6.173-1.044-9.202-2.411 18.374-7.385 37.172-6.583 56.061-3.6 19.128 3.021 35.771 12.957 54.614 20.622l-3.662-6.95c1.846-.148 3.252-.359 4.658-.36 21.485-.021 42.97.048 64.454-.082 3.262-.019 5.062.848 6.121 4.101 2.319 7.128 5.012 14.134 7.891 22.129h-127.22c.144 4.537 2.105 5.796 5.897 5.783q43.588-.154 87.175-.028c10.803.031 21.607.309 32.402.688 1.327.047 3.486 1.183 3.763 2.215 1.549 5.774 2.638 11.671 4.021 18.169H361.127c-.548 6.29-.254 6.61 5.207 6.619 38.949.061 77.898.158 116.847.146 2.863-.001 4.211.672 4.397 3.772.304 5.076.956 10.136 1.609 15.183.414 3.199-.637 4.443-4.005 4.328-6.635-.228-13.283-.105-19.926-.106q-49.152-.005-98.304.001c-6.266.001-6.266.007-6.633 6.746"- id="path5" />- <path- fill="#ff42c3"- d="M214.837 27.347c41.832-7.02 81.069-2.12 103 5.453-3.084 7.222-6.153 14.42-9.231 21.612-1.64 3.833-3.549 7.574-4.869 11.513-1.091 3.256-2.992 4.06-6.217 4.042-22.092-.119-44.185-.062-67.454-.062 3.94 4.046 6.873 7.296 12.308 7.245 16.689-.157 33.381-.056 50.072-.055h6.745c-3.661 6.1-6.056 11.84-9.975 16.217-6.139 6.856-13.44 12.659-19.972 19.184-2.516 2.514-3.687 2.416-6.101-.229-9.873-10.813-19.809-21.593-30.196-31.908-11.454-11.376-25.983-16.088-41.742-17.908-14.011-1.618-27.312.965-40.451 5.507a34.7 34.7 0 0 1-9.886 1.86c-7.248.275-14.513.085-21.995-.508 28.501-21.58 60.452-35.31 95.964-41.963m53.746 77.311 3.605-4.283h-11.056c1.525 2.155 2.339 3.846 3.653 4.931.643.531 2.216-.065 3.798-.648"- id="path6" />- <path- fill="#ff44c4"- d="M377.152 144.943c-12.092-9.869-26.287-13.386-40.919-15.513-16.956-2.465-33.583-1.51-50.074 5.653.952-1.742 1.722-3.617 2.884-5.206 15.646-21.395 34.923-38.76 58.357-51.192 3.545-1.881 8.365-1.78 12.607-1.849 13.445-.22 26.898-.165 40.345-.002 2.017.024 4.514.652 5.947 1.938 7.01 6.292 13.741 12.894 20.545 19.414.386.37.542.98 1.172 2.175h-5.468c-30.918 0-61.837.116-92.753-.114-5.213-.039-8.095 2.606-11.98 6.969h6.295c35.092-.001 70.184.065 105.275-.091 4.005-.018 6.738 1.186 8.994 4.365 3.728 5.252 7.642 10.372 12.234 16.566h-90.207l-.153 1.134c6.582 2.444 12.387 6.339 20.175 6.183 23.179-.463 46.374-.087 69.561-.245 3.754-.026 6.054 1.177 7.725 4.48 2.979 5.887 6.211 11.646 9.711 18.154-2.304.15-3.753.325-5.203.326-22.415.017-44.831-.042-67.246.074-3.19.016-5.54-.802-7.705-3.211-3.093-3.441-6.561-6.545-10.119-10.008M267.626 255.455a972 972 0 0 1-7.18.028c2.056-26.604 4.319-53.217 12.215-78.952 1.17-3.813 2.458-5.484 6.241-2.773 3.757 2.69 8.105 4.741 11.346 7.934 22.076 21.743 42.878 44.52 56.347 73.308-3.623.356-7.36.406-11.542.092-1.222-4.579-3.365-6.359-8.021-6.284-17.697.286-35.402.122-53.104.126h-6.302zm2.176-30.951h44.834l.519-1.678c-1.826-.906-3.637-2.562-5.479-2.597-12.466-.234-24.937-.104-37.407-.144-2.831-.009-4.108.992-2.467 4.419m10.378-31.312c-3.285-.223-6.209-.007-5.651 4.577h16.788c-2.211-5.078-6.298-4.716-11.137-4.577m-41.043 62.082c-3.21.24-6.22.195-9.566-.301-.214-2.054-.093-3.657.08-5.95-11.47 0-22.329-.006-33.188.003-5.917.004-6.716.761-7.574 7.07-1.888.101-3.775.202-6.063.302 4.551-9.736 8.81-19.906 14.604-29.11 10.304-16.372 21.983-31.76 37.616-43.656 7.217-5.492 15.096-9.592 23.847-11.977 1.13-.308 2.333-.345 4.833-.691-10.43 27.968-18.906 55.583-24.589 84.31m-25.72-36.778c-4.442-.439-5.459 2.888-7.32 6.624 9.882 0 19.096-.135 28.302.061 4.188.089 5.338-1.767 4.777-6.598-8.393 0-16.684 0-25.759-.087m33.855-22.914c-1.112-.66-2.178-1.777-3.343-1.89-2.903-.28-5.86.032-8.779-.147-3.761-.229-5.839 1.749-7.932 5.507 6.203 0 11.685.126 17.15-.12.95-.043 1.829-1.662 2.904-3.35m96.491-154.518c17.922 7.326 34.473 16.35 49.706 28.527-30.671-2.027-59.888 3.402-88.579 15.8.855-4.673 2.395-7.566 6.408-8.806 5.86-1.811 11.674-3.77 17.472-6.488h-16.478c5.867-11.505 11.161-22.041 16.71-32.442.395-.74 2.807-.966 4.029-.597 3.534 1.07 6.939 2.564 10.732 4.006"- id="path7" />- <path- id="path2-1"- style="fill:#ffffff;fill-opacity:1;stroke:#e330ff;stroke-width:13.374;stroke-dasharray:none;stroke-opacity:1;paint-order:stroke fill markers;filter:url(#filter7)"- d="m 145.27938,295.93815 c -0.36717,0.0115 -0.78696,0.0621 -1.31244,0.14467 -0.89347,0.19595 -1.77894,0.37878 -2.69859,0.4744 -1.31703,0.0824 -2.63241,0.20309 -3.93581,0.38514 -1.3864,0.17422 -2.76512,0.37708 -4.14651,0.57743 -1.35068,0.15854 -2.66021,0.49126 -3.98033,0.77078 -1.69225,0.28843 -3.36884,0.61937 -5.0142,1.06303 -2.33483,0.621 -4.50209,1.60062 -6.66174,2.55931 -2.83865,1.16198 -5.52832,2.55991 -8.17138,4.01008 -3.18304,1.80707 -6.31423,3.67733 -9.462934,5.52666 -3.274621,1.87793 -6.520005,3.79152 -9.73875,5.73745 -2.92949,1.74613 -5.684266,3.68507 -8.454572,5.60525 -3.032463,2.15669 -6.061316,4.31477 -8.930958,6.6269 -2.438097,1.94649 -4.163062,4.26009 -5.395985,6.87905 -0.99348,2.24644 -1.524524,4.60499 -2.050822,6.95373 -0.617702,2.72368 -0.913067,5.48545 -1.09315,8.25123 -0.223191,2.30002 0.08835,4.5875 0.701535,6.82623 0.533463,1.87247 1.484494,3.59709 2.907462,5.09573 1.871362,1.59345 4.366617,2.73481 6.860779,3.46541 2.099408,0.49017 4.210321,0.94275 6.313131,1.42214 2.05676,0.5701 4.146412,0.92196 6.297157,1.09997 1.691018,0.11146 3.38661,0.14445 5.082076,0.15796 -0.150764,0.0732 -0.301402,0.14681 -0.451814,0.22041 -2.33784,1.23387 -4.693836,2.42557 -7.147959,3.48623 -2.965179,1.18663 -5.896997,2.43199 -8.823148,3.68609 -2.537803,1.07005 -4.969591,2.30177 -7.364192,3.58356 -2.46534,1.22533 -4.774267,2.63586 -6.956316,4.19588 -2.378638,1.72346 -4.531043,3.6552 -6.897588,5.38667 -2.288037,1.65131 -4.707011,3.1643 -7.017788,4.79152 -2.247338,1.62886 -4.199321,3.52352 -6.130999,5.41373 -2.61281,2.55699 -4.760433,5.41855 -6.903725,8.2624 -1.764012,2.36792 -3.309553,4.83915 -4.83082,7.32196 -1.194327,1.79711 -2.176048,3.67791 -3.105611,5.58079 -1.062396,2.13401 -1.832866,4.346 -2.172168,6.64355 -0.06136,1.42083 -0.103686,2.90892 0.371067,4.29138 0.240851,0.70133 0.582048,1.29129 0.930646,1.95637 1.902891,2.83603 4.153568,5.49001 6.407133,8.13048 1.288086,1.57628 2.808631,2.96283 4.499098,4.22788 1.656356,1.21431 3.617814,2.0486 5.736018,2.47188 1.796048,0.37107 3.631801,0.57806 5.47369,0.6883 2.272606,0.22605 4.523463,0.62308 6.757265,1.04116 2.501815,0.55125 5.036387,0.91279 7.611116,1.08331 2.084536,0.12762 4.175299,0.11465 6.263688,0.1119 2.31306,0.0138 4.620399,0.0129 6.928658,-0.1158 2.33201,-0.25186 4.673739,-0.4186 7.009738,-0.63964 2.298279,-0.15701 4.58784,-0.35708 6.859245,-0.6961 2.389078,-0.33242 4.762364,-0.74476 7.125535,-1.19001 4.085602,-0.77201 8.133412,-1.68394 12.177512,-2.59783 3.72474,-0.83576 7.37787,-1.87639 10.91882,-3.16148 3.87139,-1.48184 7.57887,-3.22884 11.24409,-5.04108 4.19745,-2.13428 8.1013,-4.65035 11.93271,-7.22334 2.5448,-1.73661 4.88729,-3.67828 7.1753,-5.65183 1.69158,-1.50672 3.42989,-2.97579 5.09652,-4.5024 1.52776,-1.39989 2.97206,-2.86497 4.37808,-4.35305 0.64813,-0.61944 1.01439,-1.24055 1.97834,-1.50021 0.84188,-0.14302 1.7091,-0.12189 2.56379,-0.12048 0.9621,0.0681 1.90164,-0.0742 2.85431,-0.16057 0.70283,-0.0807 1.41234,-0.0968 2.12026,-0.12385 0.10979,0.0446 0.22011,0.0883 0.33109,0.13089 0.26944,0.10328 0.572,0.12834 0.86094,0.18164 1.17005,0.21589 2.3027,0.30166 3.49413,0.22561 2.99483,-0.35833 5.81648,-1.28119 8.51077,-2.41047 3.32234,-1.3696 6.28682,-3.19511 9.16655,-5.13294 0.33712,-0.23713 0.67458,-0.47409 1.01204,-0.71093 0.68174,-0.34929 1.36159,-0.70142 2.03732,-1.05886 2.2878,-1.14164 4.34275,-2.56599 6.42248,-3.95387 2.40617,-1.41895 4.56604,-3.07126 6.5957,-4.85528 2.02202,-1.70896 3.81565,-3.58575 5.56246,-5.49544 1.74525,-2.07015 3.68258,-4.01022 5.61406,-5.95447 1.6565,-1.79596 3.27612,-3.61231 5.00805,-5.35751 2.27172,-2.25994 4.5814,-4.49297 6.96367,-6.66958 -0.0763,1.78184 -0.0713,3.56556 -0.0716,5.34842 -0.007,2.49667 -0.005,4.99339 -0.01,7.49006 0.0294,2.35513 0.41125,4.68986 0.84497,7.01176 0.40091,2.13971 1.16964,4.19673 2.16694,6.18504 1.00115,1.97028 2.26291,3.83646 3.66365,5.62009 1.1279,1.50221 2.54348,2.80298 4.10442,3.98248 1.86363,1.43702 3.24449,1.67392 5.47709,1.75497 2.04239,0.0309 4.08531,0.009 6.12792,0.005 1.75107,0.0538 3.47661,-0.20351 5.19602,-0.44317 1.60342,-0.30036 3.18505,-0.67257 4.7608,-1.0625 2.56727,-0.55555 4.89376,-1.61338 7.24716,-2.60901 2.32998,-1.09539 4.76246,-2.01876 7.14674,-3.02382 3.46012,-1.56318 6.93475,-3.10203 10.41418,-4.63435 2.81675,-1.22841 5.64171,-2.44659 8.40697,-3.75713 2.39728,-1.16597 4.85958,-2.22249 7.32793,-3.27363 1.03831,-0.36738 2.01998,-0.88439 3.0893,-1.18481 0.46217,-0.0607 0.92526,-0.11631 1.38923,-0.16785 -0.56044,2.59175 -0.63821,5.23049 -0.73132,7.8575 0.005,1.58917 -0.20287,3.18917 0.10382,4.76447 0.37284,1.57161 1.34209,2.94354 2.38346,4.25598 0.91695,1.01033 1.85561,2.01644 3.07211,2.77634 1.77404,1.03734 3.72625,1.71167 5.72739,2.33656 1.12718,0.29155 2.1884,0.67538 3.22814,1.14214 0.88665,0.41804 1.78433,0.72255 2.78307,0.87124 0.89852,0.11918 1.80746,0.12223 2.71427,0.12619 1.16922,-0.004 2.33843,-0.006 3.50764,-0.01 1.77463,0.0233 3.54278,-0.0177 5.31305,-0.11919 2.42095,-0.16067 4.79459,-0.55762 7.14058,-1.07473 2.23177,-0.52594 4.35297,-1.30595 6.48882,-2.05214 1.73617,-0.60367 3.42344,-1.29532 5.11373,-1.98395 2.64985,-1.19316 5.41369,-2.16981 8.23955,-3.01653 2.61309,-0.7402 5.20304,-1.53511 7.82491,-2.25303 l -1.8564,-1.06875 c -2.61749,0.73529 -5.21702,1.51472 -7.83259,2.25486 -2.83272,0.86233 -5.60376,1.85572 -8.2878,3.01315 -1.69028,0.6793 -3.37848,1.36189 -5.10325,1.97719 -2.12571,0.74021 -4.2323,1.5292 -6.4581,2.03756 -2.34169,0.50808 -4.71338,0.88925 -7.12832,1.03777 -1.77755,0.0935 -3.55338,0.11299 -5.33424,0.0911 -1.17291,0 -2.3458,0.006 -3.51869,0 -0.89802,-0.008 -1.79922,-0.0211 -2.68632,-0.15354 -0.97713,-0.17312 -1.86093,-0.51174 -2.737,-0.91443 -1.04427,-0.46165 -2.13064,-0.80818 -3.24748,-1.12287 -0.78081,-0.2449 -1.56449,-0.49597 -2.32696,-0.78068 -0.96523,-0.676 -1.75842,-1.50148 -2.5392,-2.33967 -1.03842,-1.28331 -2.00752,-2.62915 -2.3976,-4.17064 -0.34373,-1.56709 -0.15544,-3.16852 -0.18092,-4.75405 0.0637,-2.7026 0.168,-5.41622 0.76267,-8.07974 0.0729,-0.2927 0.14927,-0.58436 0.23004,-0.87487 0.60328,-0.0551 1.20689,-0.10743 1.81003,-0.16005 3.3477,-0.34914 6.71376,-0.58073 10.03486,-1.08721 3.00953,-0.46822 5.86473,-1.41652 8.61059,-2.53589 2.2372,-0.85163 4.11445,-2.19556 5.98694,-3.50889 2.24105,-1.55022 4.18469,-3.36264 6.11317,-5.1803 1.86482,-1.91304 3.55615,-3.93674 5.0354,-6.07704 1.17886,-1.6839 2.0508,-3.49049 2.72009,-5.35883 0.45963,-1.46079 0.77677,-2.96168 0.57806,-4.47326 -0.33866,-1.38948 -2.136,-2.05415 -3.6999,-2.16664 -0.87411,-0.0922 -1.69926,0 -2.54474,0.16915 -0.8179,0.0939 -1.63039,0.23256 -2.40743,0.47179 -1.01165,0.27796 -2.07885,0.31139 -3.11846,0.4632 -1.22962,0.15561 -2.37317,0.60604 -3.47202,1.08019 -1.7214,0.86438 -3.52247,1.61268 -5.22858,2.49895 -1.76435,0.9203 -3.38096,2.03037 -4.98779,3.13493 -1.86159,1.26002 -3.4597,2.75089 -5.01819,4.26873 -1.91794,1.84617 -3.61781,3.84458 -5.39352,5.78794 -1.78515,1.96392 -3.27903,4.10297 -4.653,6.2873 -1.08862,1.66086 -1.77799,3.43771 -2.2907,5.26721 -1.23053,0.0991 -2.46037,0.21141 -3.6735,0.40023 -1.05523,0.33572 -2.03549,0.83506 -3.0589,1.2327 -2.45093,1.07287 -4.90406,2.13944 -7.30276,3.29574 -2.76746,1.29321 -5.56662,2.53886 -8.37256,3.77067 -3.47811,1.54013 -6.95212,3.08693 -10.4369,4.61562 -2.40065,0.98149 -4.83216,1.91283 -7.1584,3.01939 -2.34798,0.99346 -4.68249,2.02401 -7.24717,2.56555 -1.58181,0.37009 -3.16341,0.74067 -4.76879,1.03154 -1.70506,0.24583 -3.41821,0.4748 -5.15517,0.42911 -2.04601,0.0104 -4.09299,0.0271 -6.13837,-0.0247 -0.52364,-0.0255 -0.96164,-0.0357 -1.47892,-0.10254 -0.13087,-0.0169 -0.26149,-0.036 -0.391,-0.0596 -1.42117,-1.08656 -2.74553,-2.25201 -3.76379,-3.64369 -1.40718,-1.77106 -2.67775,-3.62296 -3.6775,-5.58625 -1.00998,-1.97484 -1.79474,-4.01935 -2.20777,-6.14938 -0.4466,-2.31104 -0.80458,-4.6376 -0.85603,-6.98237 -0.008,-2.49852 -0.0108,-4.99699 -0.005,-7.49553 0.0182,-2.15667 0.0334,-4.31422 0.15388,-6.46893 0.038,-0.57566 0.0855,-1.15053 0.13761,-1.72504 1.76469,-1.54524 3.5072,-3.10826 5.31889,-4.61456 1.71074,-1.47376 3.39249,-2.97139 5.09344,-4.45325 1.97438,-1.70361 3.9423,-3.41242 5.86714,-5.15636 1.41127,-1.30276 2.85907,-2.57603 4.31575,-3.84222 2.45137,-2.20393 4.79423,-4.49369 7.23243,-6.70992 2.03392,-1.78423 4.04675,-3.5822 5.92151,-5.48815 1.64948,-1.54835 3.3683,-3.04212 5.06489,-4.5534 1.76046,-1.77675 3.62679,-3.47312 5.4399,-5.21051 1.14558,-1.25499 2.34171,-2.47372 3.54726,-3.68816 1.29977,-1.28385 2.52477,-2.62365 3.67073,-4.00904 0.92147,-1.21654 1.92048,-2.39024 2.79842,-3.63013 0.70701,-0.91919 1.23335,-1.92204 1.78207,-2.91219 0.6774,-1.16906 1.35582,-2.33474 1.70929,-3.60697 0.30518,-1.11851 0.0828,-2.23086 -0.41526,-3.27936 -0.47955,-0.82851 -1.17671,-1.54103 -1.84596,-2.26163 -1.18233,-1.31222 -3.10165,-1.96601 -4.868,-2.56738 -1.17233,-0.37085 -2.3725,-0.68122 -3.63264,-0.64926 -0.98969,0.0506 -1.9193,0.37377 -2.80213,0.73566 -0.9291,0.32435 -1.7398,0.83463 -2.5656,1.31049 -1.57669,0.89587 -3.14851,1.79834 -4.70981,2.71363 -2.97829,1.70286 -5.73561,3.66567 -8.39684,5.70569 -2.32752,1.84495 -4.76035,3.59006 -6.8792,5.61202 -2.0542,2.0224 -3.74055,4.2723 -5.39321,6.53478 -1.3056,2.15329 -2.64351,4.2912 -3.83843,6.4908 -1.14622,2.08342 -1.94875,4.27978 -2.88874,6.43147 -0.85959,2.03126 -1.72939,4.05916 -2.70936,6.05102 -1.06655,1.85289 -2.08295,3.72414 -3.03216,5.62294 -1.01071,2.05613 -1.74064,4.19888 -2.64332,6.2886 -0.60647,1.31019 -1.1994,2.6247 -1.7827,3.94242 -0.0934,-0.41552 -0.25171,-0.81719 -0.52369,-1.19313 -1.25957,-1.33146 -3.13464,-2.18485 -5.00835,-2.7511 -1.44021,-0.44037 -2.91955,-0.45955 -4.42387,-0.38357 -1.39732,0.0819 -2.79291,0.29497 -4.13021,0.64873 -1.16892,0.27443 -2.26821,0.68807 -3.36359,1.12158 -2.29249,0.8762 -4.45006,1.97495 -6.58496,3.09459 -2.71201,1.45232 -5.30045,3.05622 -7.87928,4.67027 -2.40545,1.54634 -4.96283,2.90912 -7.37617,4.44516 -3.23066,2.12678 -6.19992,4.51434 -9.24025,6.82831 -3.52574,2.61589 -7.048,5.23716 -10.34385,8.06204 -2.22791,2.01239 -4.15514,4.24197 -5.98262,6.5202 -1.04158,1.46235 -1.57173,3.11871 -2.08401,4.75588 -0.73909,2.24156 -0.85512,4.58106 -1.00652,6.89181 -0.17834,1.85342 0.005,3.68996 0.47761,5.49934 0.3684,0.84474 0.39768,1.98049 1.26822,2.61161 0.15812,0.11465 0.34379,0.1978 0.52184,0.2899 -0.49899,0.0235 -0.99735,0.0528 -1.49336,0.10721 -0.95072,0.0824 -1.89481,0.18719 -2.85309,0.13584 -0.87388,8e-5 -1.76605,-0.0199 -2.61722,0.172 -0.96807,0.32227 -1.37146,0.95257 -2.01795,1.61001 -1.37423,1.50079 -2.80252,2.9687 -4.33387,4.35696 -1.67455,1.51785 -3.40908,2.98761 -5.09068,4.50008 -2.25855,1.98086 -4.58703,3.91634 -7.10527,5.66094 -3.8009,2.58913 -7.6856,5.10629 -11.88972,7.21422 -3.67267,1.80394 -7.40378,3.51633 -11.27695,4.99554 -3.52673,1.27211 -7.16078,2.31354 -10.86138,3.16199 -4.05889,0.92041 -8.129544,1.81458 -12.241711,2.54917 -2.369604,0.41908 -4.736248,0.85743 -7.127682,1.17882 -2.272623,0.3216 -4.560551,0.51941 -6.855861,0.6844 -2.333959,0.22494 -4.674777,0.38891 -7.00667,0.63027 -2.303296,0.12131 -4.607413,0.12083 -6.914833,0.10851 -2.08551,-0.005 -4.17334,-0.004 -6.255088,-0.12543 -2.559027,-0.18066 -5.079341,-0.5507 -7.569064,-1.08983 -2.253474,-0.42629 -4.524726,-0.83664 -6.821696,-1.0474 -1.835483,-0.12214 -3.665641,-0.32451 -5.451311,-0.71587 -0.78951,-0.17779 -0.723815,-0.14446 -1.419025,-0.36563 -0.122726,-0.0757 -0.240489,-0.13978 -0.336595,-0.17903 -1.727826,-1.25857 -3.292318,-2.63587 -4.609101,-4.22008 -2.256001,-2.61522 -4.483847,-5.25708 -6.376361,-8.07609 -0.347244,-0.64851 -0.690788,-1.23401 -0.939038,-1.91656 -0.495689,-1.36344 -0.488018,-2.83476 -0.433333,-4.24375 0.332174,-2.28173 1.099304,-4.47336 2.163234,-6.58916 0.923517,-1.89923 1.910111,-3.77232 3.083503,-5.57246 1.508272,-2.48227 3.014649,-4.96532 4.765396,-7.33444 2.126326,-2.84361 4.309774,-5.67394 6.918524,-8.22209 1.942146,-1.87306 3.890338,-3.75896 6.144445,-5.37131 2.301843,-1.63227 4.690858,-3.17333 6.989542,-4.80922 2.385406,-1.71215 4.508032,-3.66718 6.88712,-5.389 2.20507,-1.5285 4.518229,-2.92699 6.972271,-4.15762 2.389376,-1.27411 4.804985,-2.51536 7.3387,-3.57576 2.926475,-1.24415 5.834993,-2.51923 8.797348,-3.70118 2.475988,-1.05831 4.863027,-2.23152 7.233037,-3.45059 1.254869,-0.60073 2.504496,-1.21657 3.837819,-1.68652 0.05071,-0.0177 0.10152,-0.0356 0.152344,-0.0536 0.29587,-0.0562 0.591252,-0.1155 0.886121,-0.17618 0.504992,-0.11514 0.974935,-0.30875 1.474005,-0.4377 0.94137,-0.24318 0.50496,-0.0861 -1.132149,-0.85457 -0.305273,-0.21205 -0.460161,-0.30297 -0.624127,-0.3102 -0.03673,-0.0192 -0.07391,-0.0387 -0.111492,-0.0588 -0.809453,0.16009 -1.576674,0.43427 -2.339852,0.70991 -1.33715,0.25202 -2.688531,0.43731 -4.066343,0.44289 -2.160572,-0.006 -4.324077,-0.0189 -6.478378,-0.1741 -2.140105,-0.19382 -4.216727,-0.57442 -6.271042,-1.12182 -2.108585,-0.4762 -4.222377,-0.93412 -6.319583,-1.44607 -0.292206,-0.0907 -0.589141,-0.17119 -0.8766,-0.27221 -0.293759,-0.10321 -1.062243,-0.542 -0.887051,-0.35337 -0.16939,-0.10726 -0.332525,-0.22171 -0.492972,-0.3383 -0.235906,-0.17143 -0.452328,-0.36118 -0.678488,-0.54179 -1.46058,-1.45914 -2.424245,-3.16452 -2.971045,-5.02286 -0.63918,-2.2204 -0.956039,-4.50045 -0.754976,-6.78771 0.167775,-2.75643 0.442267,-5.5126 1.094684,-8.22156 0.524999,-2.33794 1.037833,-4.6878 2.020421,-6.92668 1.207926,-2.6065 2.908094,-4.88402 5.330254,-6.81659 2.849591,-2.31963 5.861127,-4.48625 8.900547,-6.62482 2.785791,-1.90151 5.5447,-3.83252 8.465012,-5.58625 3.206211,-1.95352 6.43981,-3.87457 9.71264,-5.74734 3.16643,-1.82695 6.28879,-3.70745 9.47092,-5.51495 2.6644,-1.4267 5.3621,-2.81242 8.20578,-3.97156 2.15454,-0.95615 4.32502,-1.9181 6.66174,-2.5182 1.6479,-0.43323 3.32996,-0.73717 5.01482,-1.04819 1.321,-0.27833 2.63783,-0.58144 3.98648,-0.75024 1.37621,-0.20791 2.754,-0.39883 4.13544,-0.58004 1.3096,-0.16842 2.62721,-0.28162 3.94717,-0.37159 0.92145,-0.10506 1.81089,-0.29876 2.71366,-0.47804 0.36418,-0.0549 0.73293,-0.11584 1.10419,-0.12856 0.0807,0.61072 -0.29136,1.37154 -0.4125,1.9007 -0.67363,1.68139 -1.53591,3.29747 -2.40037,4.91382 -1.01671,1.90174 -2.12084,3.76922 -3.13598,5.67162 -1.26904,2.41232 -2.56585,4.81213 -3.8931,7.202 -1.59185,2.8756 -3.27283,5.71863 -4.70061,8.65716 -1.06118,2.22923 -2.06043,4.47688 -3.11387,6.70834 -0.92702,1.88529 -1.84876,3.80722 -3.32395,5.4421 l 2.02502,1.00578 c 1.4155,-1.6839 2.31535,-3.62317 3.25946,-5.516 1.06757,-2.227 2.07414,-4.47438 3.1197,-6.70913 1.3875,-2.95011 3.07854,-5.78782 4.6576,-8.66551 1.33816,-2.38581 2.67506,-4.76902 3.94133,-7.183 1.01156,-1.9027 2.12653,-3.76404 3.15595,-5.65988 0.8835,-1.61663 1.73045,-3.24514 2.40898,-4.93206 0.24078,-0.8929 0.91161,-2.07629 0.0366,-2.85311 -1.60426,-0.85373 -2.23412,-1.17012 -3.33564,-1.13561 z m 136.41538,10.6164 c 1.23492,0.0179 2.41268,0.32261 3.55833,0.69948 0.14148,0.0505 0.28421,0.099 0.42599,0.14886 0.18572,0.14685 0.37,0.30296 0.47855,0.42806 0.66756,0.71339 1.36501,1.41212 1.87974,2.21609 0.52678,1.00342 0.77373,2.08252 0.4887,3.17214 -0.34236,1.26098 -0.99449,2.42107 -1.68226,3.57185 -0.55333,0.98146 -1.08364,1.97519 -1.77839,2.89293 -0.85922,1.24299 -1.8399,2.42104 -2.76128,3.63092 -1.1456,1.37839 -2.36901,2.71365 -3.6655,3.99186 -1.20881,1.21045 -2.40474,2.42691 -3.53865,3.68817 -1.78835,1.74885 -3.62963,3.45811 -5.39598,5.22324 -1.71296,1.50808 -3.47723,2.97583 -5.11218,4.54561 -1.84397,1.91732 -3.82924,3.7267 -5.8472,5.51313 -2.43083,2.22371 -4.80003,4.49817 -7.28926,6.67426 -1.46892,1.25844 -2.92347,2.52936 -4.31757,3.84796 -1.90375,1.75724 -3.86033,3.47273 -5.85271,5.15792 -1.71113,1.47225 -3.39526,2.96617 -5.09345,4.44907 -1.05187,0.88321 -2.08232,1.78374 -3.10556,2.68995 0.0199,-0.2159 0.039,-0.43195 0.0574,-0.64796 0.0419,-0.77452 0.10669,-0.71857 -0.59372,-1.02633 0.0629,-0.15553 0.12655,-0.31066 0.18981,-0.46555 1.02288,-2.39192 2.0784,-4.7718 3.18575,-7.1359 0.90636,-2.08452 1.63669,-4.22328 2.65223,-6.27376 0.94784,-1.89985 1.95273,-3.77563 3.03586,-5.62243 0.98099,-1.99557 1.82475,-4.03499 2.69492,-6.06689 0.93533,-2.14769 1.74871,-4.335 2.89056,-6.41402 1.18386,-2.19541 2.49137,-4.33829 3.80558,-6.47936 1.63826,-2.25712 3.32014,-4.49727 5.37234,-6.50667 2.11882,-2.00841 4.53916,-3.75271 6.83742,-5.60993 2.65975,-2.03973 5.42722,-3.98553 8.42724,-5.65991 1.57052,-0.91634 3.17,-1.79528 4.76356,-2.6824 0.81997,-0.46882 1.62591,-0.96632 2.54841,-1.28395 0.86785,-0.34013 1.77162,-0.64752 2.74129,-0.66644 z m 125.28985,52.93008 v 0 0 0 0 c -1.1e-4,0.005 0.016,0.0301 0.011,0.0401 -0.004,0.008 -0.008,0.0155 -0.0123,0.0232 -0.0151,-0.006 -0.0303,-0.0131 -0.0455,-0.0195 -0.36244,0.41836 -0.68338,0.85882 -0.97919,1.31207 -1.21556,1.36275 -2.42315,2.73028 -3.63174,4.0975 -2.09696,2.36023 -4.0917,4.78526 -6.28947,7.08046 -1.28199,1.31908 -2.55466,2.6452 -3.86577,3.94372 -3.85962,3.82256 0.92854,-0.95802 -2.95845,2.87549 -0.44829,0.44211 -0.8861,0.89183 -1.32903,1.33781 -2.9276,3.15135 -5.70675,6.39908 -8.55746,9.60024 -2.54854,2.85123 -4.94662,5.79254 -7.11633,8.86275 -1.15886,1.6411 -2.29672,3.29401 -3.53897,4.89119 l 2.04131,0.98469 c 1.0626,-1.68111 2.17827,-3.33909 3.30984,-4.98773 2.09792,-3.09615 4.51959,-6.01801 7.00145,-8.8984 2.79567,-3.23678 5.63919,-6.44367 8.60783,-9.56823 2.69756,-2.7336 5.49267,-5.39571 8.16186,-8.14947 0.1955,-0.20028 0.3895,-0.40158 0.58174,-0.60398 -0.0278,0.0371 -0.0558,0.074 -0.0836,0.11111 -2.22788,2.8751 -4.41277,5.77386 -6.70535,8.61268 -2.29748,2.84831 -4.54765,5.72407 -6.72041,8.64182 -2.10186,2.82972 -4.17312,5.67502 -6.29717,8.49296 -1.45224,1.89873 -2.65942,3.92233 -3.61053,6.03463 -0.52818,1.25044 -1.12744,2.47958 -1.4614,3.78029 -0.14266,0.67061 -0.29107,1.34994 -0.17108,2.02951 0.37251,1.17307 1.67728,1.4225 2.90009,2.01179 0.69486,0.16085 1.38232,0.0663 2.06864,-0.0681 0.17317,-0.055 0.35279,-0.0976 0.51971,-0.16498 0.32642,-0.13191 1.36915,-0.65352 1.62665,-0.78511 1.03581,-0.52931 2.05238,-1.08578 3.06994,-1.63967 2.69145,-1.35318 4.93546,-3.21201 7.19926,-5.01819 2.3698,-1.84551 4.50915,-3.87865 6.61076,-5.93912 1.44107,-1.38261 2.70526,-2.88363 4.00552,-4.3598 1.27576,-1.44838 1.29954,-1.46155 2.62336,-2.91245 2.5668,-2.80039 5.13493,-5.59987 7.8332,-8.31056 3.01064,-2.92148 6.44428,-5.5046 9.99216,-7.94519 1.52886,-1.03762 3.10645,-2.03043 4.81209,-2.85129 0.73184,-0.3522 1.40277,-0.63347 2.15188,-0.95763 2.03089,-0.87607 4.11889,-1.65321 6.20746,-2.42425 1.8223,-0.70948 3.7319,-1.22747 5.66384,-1.67169 1.87466,-0.4139 3.76612,-0.77007 5.66719,-1.08489 0.43673,-0.0501 0.90094,-0.15011 1.36004,-0.18658 0.0878,0.14936 0.1666,0.30253 0.24604,0.45644 0.41672,0.85299 0.56342,1.74559 0.56208,2.66184 -0.0724,1.44334 -0.57672,2.83053 -1.14967,4.17974 -0.75269,1.58869 -1.83233,3.04355 -2.90869,4.48524 -1.15529,1.44547 -2.38721,2.84568 -3.52853,4.29919 -1.34013,1.68268 -2.34449,3.52885 -3.22628,5.40956 -0.96585,2.13582 -1.59202,4.36329 -2.03393,6.61518 -0.2563,1.56547 -0.38972,3.14871 -0.37011,4.72934 0.0892,1.14554 0.22023,2.29594 0.58818,3.40323 0.32035,1.07651 1.03305,1.99306 1.73968,2.90905 0.76146,0.92396 1.41789,1.90711 2.229,2.80107 0.50021,0.54654 1.08869,1.01637 1.75748,1.40964 1.16142,-0.10809 1.66553,0.92188 2.5733,1.25689 0.47873,0.17666 1.01318,0.28113 1.51855,0.38617 0.754,0.13956 1.511,0.24056 2.28056,0.28885 1.01045,0.0465 2.02259,0.0403 3.03403,0.0348 2.07536,-0.0756 4.14076,-0.28487 6.19395,-0.54543 2.31453,-0.37577 4.63383,-0.757 6.91392,-1.26469 1.64137,-0.42504 3.20604,-1.03276 4.76846,-1.6285 2.17229,-0.91417 4.2049,-2.04793 6.21822,-3.18853 2.63332,-1.4877 4.76269,-3.47218 6.81809,-5.48582 0.73687,-0.71218 1.46622,-1.42986 2.20286,-2.14217 0.10733,-0.10377 0.21088,-0.20994 0.31822,-0.31174 0.30446,0.47453 0.58136,0.96073 0.78692,1.47313 0.39971,0.8656 0.34004,1.77408 0.29454,2.68396 -0.22287,1.93643 -0.62035,3.87348 -1.29401,5.73667 -0.14506,0.40119 -0.32369,0.79321 -0.4856,1.18976 -0.50069,0.96252 -0.89838,2.0494 -1.76335,2.83982 -0.28893,0.26405 -0.42235,0.30198 -0.77677,0.47804 -0.16608,0.0719 -0.53997,0.19561 -0.63242,0.37082 -0.34178,0.64759 0.47564,1.7107 0.8164,2.24392 0.60678,0.82357 0.29766,0.4307 0.92237,1.18116 l 2.06065,0.75596 c -0.64747,-0.73901 -0.33063,-0.35199 -0.94601,-1.164 -0.22847,-0.34946 -1.07683,-1.55149 -0.87537,-1.98472 0.0635,-0.13661 0.49292,-0.30483 0.58511,-0.34845 0.13908,-0.0776 0.2884,-0.14369 0.41742,-0.2329 1.1189,-0.77358 1.50084,-2.20719 2.05543,-3.26869 0.15929,-0.40198 0.33206,-0.80026 0.47793,-1.20588 0.67108,-1.86591 1.11192,-3.79017 1.43101,-5.71975 0.0711,-0.91726 0.20637,-1.8403 -0.19228,-2.72041 -0.2458,-0.67396 -0.63884,-1.2948 -1.03203,-1.91447 -0.61207,-0.92497 -1.57958,-2.27012 -3.12922,-1.94231 -0.38291,0.25007 -0.64727,0.56895 -0.94848,0.88945 -0.69262,0.73698 -1.40173,1.46205 -2.11902,2.18198 -2.01067,2.03066 -4.15848,3.97563 -6.79166,5.44053 -2.02177,1.13895 -4.08471,2.23826 -6.28609,3.11411 -1.54955,0.58762 -3.09684,1.1952 -4.72273,1.61834 -2.26374,0.51839 -4.56531,0.91563 -6.87367,1.26235 -2.06956,0.25459 -4.15281,0.45465 -6.24616,0.4796 -1.01936,-0.009 -2.04028,-0.009 -3.05767,-0.0692 -0.7624,-0.0608 -1.51514,-0.17024 -2.26123,-0.31722 -0.29618,-0.0664 -0.59129,-0.13499 -0.8806,-0.21962 -0.37559,-0.26274 -0.72063,-0.55502 -1.03079,-0.88009 -0.844,-0.87638 -1.50132,-1.86401 -2.25907,-2.79325 -0.69442,-0.90371 -1.42252,-1.79801 -1.75996,-2.85416 -0.38186,-1.09234 -0.53068,-2.2299 -0.62781,-3.36392 -0.0571,-1.57894 0.0511,-3.16174 0.28626,-4.72856 0.40342,-2.24562 1.00354,-4.47123 1.97896,-6.59254 0.91422,-1.85455 1.91476,-3.68668 3.2567,-5.35205 1.14641,-1.45221 2.37792,-2.85438 3.5282,-4.30439 1.08687,-1.45209 2.18372,-2.91345 2.94986,-4.51231 0.58696,-1.36248 1.10902,-2.76135 1.22613,-4.21772 0.0245,-0.93137 -0.0843,-1.84035 -0.48345,-2.71702 -0.63207,-1.34862 -0.99728,-1.65708 -3.03247,-2.36779 -0.84054,-0.15908 -1.68788,0.0639 -2.51462,0.19153 -1.88741,0.33839 -3.76745,0.70803 -5.63496,1.11844 -1.94151,0.44412 -3.86383,0.9554 -5.68131,1.69512 -2.08386,0.77987 -4.17356,1.55471 -6.19672,2.4435 -1.10199,0.48008 -2.20927,0.95841 -3.24595,1.5369 -1.27614,0.71213 -2.44767,1.5514 -3.63234,2.36519 -2.34372,1.68222 -4.62828,3.41499 -6.84602,5.2162 -0.58865,0.4781 -1.18685,0.94872 -1.75475,1.44451 -0.48547,0.42387 -0.93596,0.87535 -1.40397,1.3131 -2.72514,2.69354 -5.22693,5.54024 -7.81385,8.32878 -2.23188,2.41076 -4.41099,4.85786 -6.72134,7.21474 -2.09773,2.0491 -4.21204,4.08998 -6.54747,5.95031 -2.27495,1.7965 -4.58636,3.58673 -7.27144,4.94115 -1.19,0.64944 -0.89193,0.49733 -2.11471,1.12184 -0.85535,0.43686 -1.7183,0.89429 -2.64855,1.21161 -0.16735,0.0571 -0.3442,0.0914 -0.51631,0.13714 -0.31855,0.0506 -0.64117,0.0932 -0.96167,0.0997 -0.009,-0.022 -0.0181,-0.0444 -0.0261,-0.0672 -0.17102,-0.65473 -0.0238,-1.32573 0.0869,-1.98084 0.3068,-1.3001 0.86557,-2.53752 1.36834,-3.79017 0.92526,-2.10855 2.08959,-4.13789 3.49473,-6.04868 2.07064,-2.84527 4.16483,-5.67842 6.26001,-8.51066 2.19015,-2.9059 4.40614,-5.79705 6.70749,-8.64105 2.2983,-2.83867 4.50439,-5.72755 6.71919,-8.6132 2.10371,-2.83421 4.22215,-5.66383 6.04007,-8.64025 0.26563,-0.42276 0.5328,-0.84497 0.79705,-1.26834 0.3087,-0.49461 0.60422,-1.00399 0.93803,-1.49213 0.10664,-0.11187 0.21314,-0.22378 0.31975,-0.3357 0.26092,-0.28629 0.51326,-0.57821 0.75312,-0.87747 0.10809,-0.13486 0.17054,-0.21708 0.16617,-0.23081 v 0 0 0 0 0 0 c -0.4949,-0.23587 -1.00654,-0.44515 -1.517,-0.65629 -0.18633,-0.10115 -0.37352,-0.20162 -0.56148,-0.30056 0,0 -0.002,0 -0.002,-8.9e-4 -1.4e-4,-3e-5 0,2e-5 0,0 v 0 0 z m -181.78089,0.1439 c 1.10395,0.009 2.19031,0.1291 3.2487,0.46789 0.12518,0.0423 0.23432,0.0794 0.32773,0.11137 0.25622,0.19897 0.48937,0.42029 0.72027,0.63859 0.2179,0.25509 0.38018,0.40296 0.49543,0.71068 0.33549,0.89581 0.1909,1.88002 0.29731,2.79846 0.0245,1.04912 0.0639,2.13183 -0.12654,3.17761 -0.099,0.26066 -0.19459,0.5178 -0.27243,0.73618 -0.85537,1.15899 -1.72945,2.3098 -2.73884,3.3785 -1.38289,1.44306 -2.78663,2.86677 -4.27306,4.23516 -2.47894,2.31481 -4.89154,4.67931 -7.1756,7.13487 -2.02322,2.1463 -4.06379,4.28062 -6.06343,6.44238 -1.9547,2.00887 -3.88192,4.03691 -5.84196,6.04192 -2.2154,2.23088 -4.48391,4.43334 -7.05735,6.37708 -2.00125,1.46485 -4.03318,2.89924 -6.0671,4.33144 -1.79617,0.93024 -3.60774,1.83961 -5.41379,2.75553 -1.90971,0.91044 -3.82004,1.84519 -5.87514,2.50285 -2.08496,0.62671 -4.14576,1.33602 -6.31958,1.71931 -1.47692,0.28567 -2.97305,0.47518 -4.47546,0.63703 -0.3449,0.0321 -0.69104,0.0535 -1.03756,0.0711 -0.418,-0.59568 -0.50832,-1.38657 -0.78382,-2.00608 -0.50119,-1.79634 -0.71071,-3.62125 -0.54766,-5.46916 0.12911,-2.29696 0.267,-4.61915 1.01452,-6.8434 0.50192,-1.61708 1.03279,-3.25054 2.04222,-4.70174 1.78651,-2.28443 3.64525,-4.54026 5.88497,-6.52801 3.28909,-2.82335 6.77973,-5.46716 10.32202,-8.05996 3.047,-2.30926 6.03311,-4.68489 9.29462,-6.78016 2.41613,-1.52909 4.95786,-2.90812 7.36328,-4.45064 2.57546,-1.60958 5.15943,-3.21117 7.87038,-4.6557 2.14905,-1.10684 4.3156,-2.19795 6.6304,-3.04229 1.09322,-0.42168 2.19578,-0.81167 3.35161,-1.09632 1.32957,-0.33937 2.71008,-0.5413 4.09644,-0.611 0.3715,-0.0174 0.74143,-0.0266 1.10942,-0.0235 z m 2.60461,0.0154 c -0.17761,-0.0917 0.36675,0.16757 0.53781,0.26778 0.0183,0.0107 0.0364,0.0215 0.0543,0.0325 -0.17195,-0.0857 -0.36972,-0.18551 -0.59218,-0.3003 z m 120.51707,1.96574 c 0.18085,0 0.36246,0.005 0.54519,0.0179 0.0241,0.0465 0.0459,0.0939 0.0651,0.14181 0.26995,1.4855 -0.0588,2.9719 -0.50188,4.4129 -0.66046,1.85642 -1.50149,3.65568 -2.67648,5.3276 -1.46687,2.12978 -3.11533,4.16497 -4.99024,6.05413 -1.92682,1.80822 -3.87975,3.6046 -6.11656,5.14544 -1.86376,1.30115 -3.7408,2.61715 -5.95837,3.46932 -2.72218,1.117 -5.55328,2.05855 -8.54426,2.51091 -3.18375,0.47288 -6.40553,0.71176 -9.61588,1.02165 0.47577,-1.42332 1.08826,-2.80701 1.93501,-4.11989 1.35816,-2.17918 2.83114,-4.31547 4.61215,-6.26935 1.77997,-1.93714 3.48998,-3.92543 5.40611,-5.76918 1.55523,-1.50998 3.16364,-2.97697 5.02066,-4.22841 1.59556,-1.10407 3.21089,-2.20237 4.97273,-3.11203 1.7078,-0.87873 3.49319,-1.64753 5.23412,-2.47657 1.09315,-0.45623 2.2299,-0.87869 3.44621,-1.02242 1.05588,-0.13511 2.1296,-0.20336 3.15195,-0.48505 0.78191,-0.21651 1.58469,-0.35264 2.39791,-0.4528 0.53832,-0.10622 1.07397,-0.16463 1.61652,-0.16603 z m -276.520218,3.83261 c 0.143166,0.0561 0.285809,0.11349 0.412506,0.18762 0.03402,0.0199 0.05053,0.0307 0.05279,0.0341 v 0 h 3.16e-4 v 0 h -3.16e-4 v 0 h -3.16e-4 -3.07e-4 -3.16e-4 c -0.01696,0 -0.235941,-0.10676 -0.464411,-0.22274 z m 376.859488,0.33828 c 0.0438,0.0128 0.0874,0.0269 0.13051,0.0429 0.43815,0.2662 0.28985,0.17367 -0.13051,-0.0429 z m -215.63174,2.03861 c 0.0337,-0.004 0.0462,0.1228 0.009,0.10956 -0.0348,-0.0123 -0.069,-0.0248 -0.1026,-0.037 0.0245,-0.029 0.0523,-0.0542 0.0888,-0.0711 0.002,-8.9e-4 0.004,-0.002 0.005,-0.002 z m -2.20747,2.84296 c -0.0146,0.16175 -0.0295,0.32355 -0.0439,0.48533 -0.24401,0.21722 -0.48826,0.43428 -0.73287,0.65107 -0.26956,0.24362 -0.53807,0.48792 -0.80565,0.73305 0.56138,-0.60281 1.08329,-1.22956 1.58244,-1.86945 z m -12.59984,12.67062 c -0.52101,0.56911 -1.03869,1.14056 -1.55878,1.71151 -0.34524,0.35144 -0.69064,0.70277 -1.0351,1.05469 0.66066,-0.70511 1.32201,-1.40958 1.98325,-2.11433 0.20259,-0.21799 0.40611,-0.43526 0.61063,-0.65187 z m -6.86508,7.34486 c -0.0969,0.11244 -0.19343,0.22519 -0.28934,0.33829 -1.27664,1.38197 -2.58389,2.7428 -3.97358,4.0426 1.42052,-1.46048 2.83553,-2.92519 4.26292,-4.38089 z" />-</svg>diff --git a/docs/Caveats.md b/docs/Caveats.mdindex ac847d052d..512985cd8a 100644--- a/docs/Caveats.md+++ b/docs/Caveats.md@@ -77,6 +77,8 @@ For this reason this patch is NOT applied to default on all platforms (for obvioStill will not run flawlessly until `mesa-24` is available. Modify CMakeCache.txt with the `.so` of libGL and libGLESv2 by doing the incredibly difficult task of copy pasting them (`cp /boot/system/lib/libGL.so .`)+If you have `quazip1_qt6_devel`, uninstall it. It may call `Core5Compat` on CMake which is wrongly packaged.+## OpenBSDAfter configuration, you may need to modify `externals/ffmpeg/CMakeFiles/ffmpeg-build/build.make` to use `-j$(nproc)` instead of just `-j`.@@ -99,11 +101,17 @@ ip6addrctl=YESip6addrctl_policy=ipv4_prefer```-System provides a default `g++-10` which doesn't support the current C++ codebase; install `clang-19` with `pkgin install clang-19`. Then build with `cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_COMPILER=clang++ -DCMAKE_C_COMPILER=clang -B build`.+System provides a default `g++-10` which doesn't support the current C++ codebase; install `clang-19` with `pkgin install clang-19`. Or install `gcc14` (or `gcc15` with current pkgsrc). Provided that, the following CMake commands may work:++- `cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++ -Bbuild`+- `cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_C_COMPILER=/usr/pkg/gcc14/bin/gcc -DCMAKE_CXX_COMPILER=/usr/pkg/gcc14/bin/g++ -Bbuild`+- `cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_C_COMPILER=/usr/pkg/gcc15/bin/gcc -DCMAKE_CXX_COMPILER=/usr/pkg/gcc15/bin/g++ -Bbuild`Make may error out when generating C++ headers of SPIRV shaders, hence it's recommended to use `gmake` over the default system one.-glslang is not available on NetBSD, to circumvent this simply build glslang by yourself:+[parallel/spirv-tools](https://iso.us.netbsd.org/pub/pkgsrc/current/pkgsrc/parallel/spirv-tools/index.html) isn't available in binary form and must be build from source.++Such that glslang is not available on NetBSD, to circumvent this simply build glslang by yourself:```shpkgin python313git clone --depth=1 https://github.com/KhronosGroup/glslang.git@@ -114,6 +122,8 @@ cmake --build build -- -j`nproc`cmake --install build```+However, pkgsrc is highly recommended, see [getting pkgsrc](https://iso.us.netbsd.org/pub/pkgsrc/current/pkgsrc/doc/pkgsrc.html#getting). You must get `current` not the `2025Q2` version.+# DragonFlyBSDIf `libstdc++.so.6` is not found (`GLIBCXX_3.4.30`) then attempt:diff --git a/docs/Deps.md b/docs/Deps.mdindex 05764341ec..28e5d61649 100644--- a/docs/Deps.md+++ b/docs/Deps.md@@ -183,6 +183,8 @@ sudo dnf config-manager --enable crbsudo dnf install qt6-qtbase-private-devel```+For systems like OpenEuler or derivates, don't forget to also install: `SDL2-devel pkg-config fmt-dev nlohmann-json-dev`.+* [RPM Fusion](https://rpmfusion.org/Configuration) is required for `ffmpeg-devel`* Fedora 32 or later is required.* Fedora 36+ users with GCC 12 need Clang and should configure CMake with: `cmake -DCMAKE_CXX_COMPILER=clang++ -DCMAKE_C_COMPILER=clang -B build`@@ -241,7 +243,7 @@ brew install molten-vk vulkan-loader<details><summary>FreeBSD</summary>-As root run: `pkg install devel/cmake devel/sdl20 devel/boost-libs devel/catch2 devel/libfmt devel/nlohmann-json devel/ninja devel/nasm devel/autoconf devel/pkgconf devel/qt6-base devel/simpleini net/enet multimedia/ffnvcodec-headers multimedia/ffmpeg audio/opus archivers/liblz4 lang/gcc12 graphics/glslang graphics/vulkan-utility-libraries graphics/spirv-tools www/cpp-httplib devel/jwt-cpp devel/unordered-dense mbedtls3 vulkan-headers quazip-qt6`+As root run: `pkg install devel/cmake devel/sdl20 devel/boost-libs devel/catch2 devel/libfmt devel/nlohmann-json devel/ninja devel/nasm devel/autoconf devel/pkgconf devel/qt6-base devel/simpleini net/enet multimedia/ffnvcodec-headers multimedia/ffmpeg audio/opus archivers/liblz4 lang/gcc12 graphics/glslang graphics/vulkan-utility-libraries graphics/spirv-tools www/cpp-httplib devel/unordered-dense mbedtls3 vulkan-headers quazip-qt6`If using FreeBSD 12 or prior, use `devel/pkg-config` instead.@@ -251,7 +253,7 @@ If using FreeBSD 12 or prior, use `devel/pkg-config` instead.<details><summary>NetBSD</summary>-For NetBSD +10.1: `pkgin install git cmake boost fmtlib SDL2 catch2 libjwt spirv-headers ffmpeg7 libva nlohmann-json jq libopus qt6 mbedtls3 cpp-httplib lz4 vulkan-headers nasm autoconf enet pkg-config libusb1`.+For NetBSD +10.1: `pkgin install git cmake boost fmtlib SDL2 catch2 libjwt spirv-headers ffmpeg7 libva nlohmann-json jq libopus qt6 mbedtls3 cpp-httplib lz4 vulkan-headers nasm autoconf enet pkg-config libusb1 libcxx`.[Caveats](./Caveats.md#netbsd).@@ -320,7 +322,7 @@ pacman -Syuu --needed --noconfirm $packages<summary>HaikuOS</summary>```sh-pkgman install git cmake patch libfmt_devel nlohmann_json lz4_devel opus_devel boost1.89_devel vulkan_devel qt6_base_devel libsdl2_devel ffmpeg7_devel libx11_devel enet_devel catch2_devel quazip1_qt6_devel qt6_5compat_devel libusb1_devel libz_devel mbedtls3_devel glslang+pkgman install git cmake patch libfmt_devel nlohmann_json lz4_devel opus_devel boost1.89_devel vulkan_devel qt6_base_devel qt6_declarative_devel libsdl2_devel ffmpeg7_devel libx11_devel enet_devel catch2_devel quazip1_qt5_devel qt6_5compat_devel mbedtls3_devel glslang qt6_devel```[Caveats](./Caveats.md#haikuos).diff --git a/docs/NvidiaGpu.md b/docs/NvidiaGpu.mdnew file mode 100644index 0000000000..d7fe3d86d3--- /dev/null+++ b/docs/NvidiaGpu.md@@ -0,0 +1,874 @@+# The NVIDIA SM86 (Maxwell) GPU - Instruction set++<!-- TOC -->+[AL2P](#AL2P)+[ALD](#ALD)+[AST](#AST)+[ATOM](#ATOM)+[ATOMS](#ATOMS)+[B2R](#B2R)+[BAR](#BAR)+[BFE](#BFE)+[BFI](#BFI)+[BPT](#BPT)+[BRA](#BRA)+[BRK](#BRK)+[BRX](#BRX)+[CAL](#CAL)+[CCTL](#CCTL)+[CCTLL](#CCTLL)+[CONT](#CONT)+[CS2R](#CS2R)+[CSET](#CSET)+[CSETP](#CSETP)+[DADD](#DADD)+[DEPBAR](#DEPBAR)+[DFMA](#DFMA)+[DMNMX](#DMNMX)+[DMUL](#DMUL)+[DSET](#DSET)+[DSETP](#DSETP)+[EXIT](#EXIT)+[F2F](#F2F)+[F2I](#F2I)+[FADD](#FADD)+[FCHK](#FCHK)+[FCMP](#FCMP)+[FFMA](#FFMA)+[FLO](#FLO)+[FMNMX](#FMNMX)+[FMUL](#FMUL)+[FSET](#FSET)+[FSETP](#FSETP)+[FSWZADD](#FSWZADD)+[GETCRSPTR](#GETCRSPTR)+[GETLMEMBASE](#GETLMEMBASE)+[HADD2](#HADD2)+[HFMA2](#HFMA2)+[HMUL2](#HMUL2)+[HSET2](#HSET2)+[HSETP2](#HSETP2)+[I2F](#I2F)+[I2I](#I2I)+[IADD](#IADD)+[IADD3](#IADD3)+[ICMP](#ICMP)+[IDE](#IDE)+[IDP](#IDP)+[IMAD](#IMAD)+[IMADSP](#IMADSP)+[IMNMX](#IMNMX)+[IMUL](#IMUL)+[IPA](#IPA)+[ISBERD](#ISBERD)+[ISCADD](#ISCADD)+[ISET](#ISET)+[ISETP](#ISETP)+[JCAL](#JCAL)+[JMP](#JMP)+[JMX](#JMX)+[KIL](#KIL)+[LD](#LD)+[LDC](#LDC)+[LDG](#LDG)+[LDL](#LDL)+[LDS](#LDS)+[LEA](#LEA)+[LEPC](#LEPC)+[LONGJMP](#LONGJMP)+[LOP](#LOP)+[LOP3](#LOP3)+[MEMBAR](#MEMBAR)+[MOV](#MOV)+[MUFU](#MUFU)+[NOP](#NOP)+[OUT](#OUT)+[P2R](#P2R)+[PBK](#PBK)+[PCNT](#PCNT)+[PEXIT](#PEXIT)+[PIXLD](#PIXLD)+[PLONGJMP](#PLONGJMP)+[POPC](#POPC)+[PRET](#PRET)+[PRMT](#PRMT)+[PSET](#PSET)+[PSETP](#PSETP)+[R2B](#R2B)+[R2P](#R2P)+[RAM](#RAM)+[RED](#RED)+[RET](#RET)+[RRO](#RRO)+[RTT](#RTT)+[S2R](#S2R)+[SAM](#SAM)+[SEL](#SEL)+[SETCRSPTR](#SETCRSPTR)+[SETLMEMBASE](#SETLMEMBASE)+[SHF](#SHF)+[SHFL](#SHFL)+[SHL](#SHL)+[SHR](#SHR)+[SSY](#SSY)+[ST](#ST)+[STG](#STG)+[STL](#STL)+[STP](#STP)+[STS](#STS)+[SUATOM](#SUATOM)+[SULD](#SULD)+[SURED](#SURED)+[SUST](#SUST)+[SYNC](#SYNC)+[TEX](#TEX)+[TLD](#TLD)+[TLD4](#TLD4)+[TMML](#TMML)+[TXA](#TXA)+[TXD](#TXD)+[TXQ](#TXQ)+[VABSDIFF](#VABSDIFF)+[VABSDIFF4](#VABSDIFF4)+[VADD](#VADD)+[VMAD](#VMAD)+[VMNMX](#VMNMX)+[VOTE](#VOTE)+[VSET](#VSET)+[VSETP](#VSETP)+[VSHL](#VSHL)+[VSHR](#VSHR)+[XMAD](#XMAD)+<!-- /TOC -->++NOTE: Regenerate TOC with `cat docs/gpu/README.md | grep '#' | cut -d '#' -f 2 | tr -d ' ' | awk '{print "["$1"](#"$1")"}'`.++The numbers (in binary) represent the opcodes; `-` signifies "don't care".++# AL2P+`1110 1111 1010 0---`++# ALD+`1110 1111 1101 1---`++# AST+`1110 1111 1111 0---`++# ATOM+- **ATOM_cas**: `1110 1110 1111 ----`+- **ATOM**: `1110 1101 ---- ----`++Atomic operation.++- INC, DEC for U32/S32/U64 does nothing.+- ADD, INC, DEC for S64 does nothing.+- Only ADD does something for F32.+- Only ADD, MIN and MAX does something for F16x2.++# ATOMS+- **ATOMS_cas**: `1110 1110 ---- ----`+- **ATOMS**: `1110 1100 ---- ----`++# B2R+`1111 0000 1011 1---`++# BAR+`1111 0000 1010 1---`++# BFE+- **BFE_reg**: `0101 1100 0000 0---`+- **BFE_cbuf**: `0100 1100 0000 0---`+- **BFE_imm**: `0011 100- 0000 0---`++Bit Field Extract.++# BFI+- **BFI_reg**: `0101 1011 1111 0---`+- **BFI_rc**: `0101 0011 1111 0---`+- **BFI_cr**: `0100 1011 1111 0---`+- **BFI_imm**: `0011 011- 1111 0---`++Bit Field Insert.++# BPT+`1110 0011 1010 ----`++Breakpoint trap.++# BRA+`1110 0010 0100 ----`++Relative branch.++# BRK+`1110 0011 0100 ----`++Break.++# BRX+`1110 0010 0101 ----`++# CAL+`1110 0010 0110 ----`++# CCTL+`1110 1111 011- ----`++Cache Control.++# CCTLL+`1110 1111 100- ----`++Texture Cache Control.++# CONT+`1110 0011 0101 ----`++Continue.++# CS2R+`0101 0000 1100 1---`++Move Special Register to Register.++# CSET+`0101 0000 1001 1---`++Test Condition Code And Set.++# CSETP+`0101 0000 1010 0---`++Test Condition Code and Set Predicate.++# DADD+- **DADD_reg**: `0101 1100 0111 0---`+- **DADD_cbuf**: `0100 1100 0111 0---`+- **DADD_imm**: `0011 100- 0111 0---`++# DEPBAR+`1111 0000 1111 0---`++# DFMA+- **DFMA_reg**: `0101 1011 0111 ----`+- **DFMA_rc**: `0101 0011 0111 ----`+- **DFMA_cr**: `0100 1011 0111 ----`+- **DFMA_imm**: `0011 011- 0111 ----`++FP64 Fused Mutiply Add.++# DMNMX+- **DMNMX_reg**: `0101 1100 0101 0---`+- **DMNMX_cbuf**: `0100 1100 0101 0---`+- **DMNMX_imm**: `0011 100- 0101 0---`++FP64 Minimum/Maximum.++# DMUL+- **DMUL_reg**: `0101 1100 1000 0---`+- **DMUL_cbuf**: `0100 1100 1000 0---`+- **DMUL_imm**: `0011 100- 1000 0---`++FP64 Multiply.++# DSET+- **DSET_reg**: `0101 1001 0--- ----`+- **DSET_cbuf**: `0100 1001 0--- ----`+- **DSET_imm**: `0011 001- 0--- ----`++FP64 Compare And Set.++# DSETP+- **DSETP_reg**: `0101 1011 1000 ----`+- **DSETP_cbuf**: `0100 1011 1000 ----`+- **DSETP_imm**: `0011 011- 1000 ----`++FP64 Compare And Set Predicate.++# EXIT+`1110 0011 0000 ----`++# F2F+- **F2F_reg**: `0101 1100 1010 1---`+- **F2F_cbuf**: `0100 1100 1010 1---`+- **F2F_imm**: `0011 100- 1010 1---`++# F2I+- **F2I_reg**: `0101 1100 1011 0---`+- **F2I_cbuf**: `0100 1100 1011 0---`+- **F2I_imm**: `0011 100- 1011 0---`++# FADD+- **FADD_reg**: `0101 1100 0101 1---`+- **FADD_cbuf**: `0100 1100 0101 1---`+- **FADD_imm**: `0011 100- 0101 1---`+- **FADD32I**: `0000 10-- ---- ----`++FP32 Add.++# FCHK+- **FCHK_reg**: `0101 1100 1000 1---`+- **FCHK_cbuf**: `0100 1100 1000 1---`+- **FCHK_imm**: `0011 100- 1000 1---`++Single Precision FP Divide Range Check.++# FCMP+- **FCMP_reg**: `0101 1011 1010 ----`+- **FCMP_rc**: `0101 0011 1010 ----`+- **FCMP_cr**: `0100 1011 1010 ----`+- **FCMP_imm**: `0011 011- 1010 ----`++FP32 Compare to Zero and Select Source.++# FFMA+- **FFMA_reg**: `0101 1001 1--- ----`+- **FFMA_rc**: `0101 0001 1--- ----`+- **FFMA_cr**: `0100 1001 1--- ----`+- **FFMA_imm**: `0011 001- 1--- ----`+- **FFMA32I**: `0000 11-- ---- ----`++FP32 Fused Multiply and Add.++# FLO+- **FLO_reg**: `0101 1100 0011 0---`+- **FLO_cbuf**: `0100 1100 0011 0---`+- **FLO_imm**: `0011 100- 0011 0---`++# FMNMX+- **FMNMX_reg**: `0101 1100 0110 0---`+- **FMNMX_cbuf**: `0100 1100 0110 0---`+- **FMNMX_imm**: `0011 100- 0110 0---`++FP32 Minimum/Maximum.++# FMUL+- **FMUL_reg**: `0101 1100 0110 1---`+- **FMUL_cbuf**: `0100 1100 0110 1---`+- **FMUL_imm**: `0011 100- 0110 1---`+- **FMUL32I**: `0001 1110 ---- ----`++FP32 Multiply.++# FSET+- **FSET_reg**: `0101 1000 ---- ----`+- **FSET_cbuf**: `0100 1000 ---- ----`+- **FSET_imm**: `0011 000- ---- ----`++FP32 Compare And Set.++# FSETP+- **FSETP_reg**: `0101 1011 1011 ----`+- **FSETP_cbuf**: `0100 1011 1011 ----`+- **FSETP_imm**: `0011 011- 1011 ----`++FP32 Compare And Set Predicate.++# FSWZADD+`0101 0000 1111 1---`++FP32 Add used for FSWZ emulation.++# GETCRSPTR+`1110 0010 1100 ----`++# GETLMEMBASE+`1110 0010 1101 ----`++# HADD2+- **HADD2_reg**: `0101 1101 0001 0---`+- **HADD2_cbuf**: `0111 101- 1--- ----`+- **HADD2_imm**: `0111 101- 0--- ----`+- **HADD2_32I**: `0010 110- ---- ----`++FP16 Add.++# HFMA2+- **HFMA2_reg**: `0101 1101 0000 0---`+- **HFMA2_rc**: `0110 0--- 1--- ----`+- **HFMA2_cr**: `0111 0--- 1--- ----`+- **HFMA2_imm**: `0111 0--- 0--- ----`+- **HFMA2_32I**: `0010 100- ---- ----`++FP16 Fused Mutiply Add.++# HMUL2+- **HMUL2_reg**: `0101 1101 0000 1---`+- **HMUL2_cbuf**: `0111 100- 1--- ----`+- **HMUL2_imm**: `0111 100- 0--- ----`+- **HMUL2_32I**: `0010 101- ---- ----`++FP16 Multiply.++# HSET2+- **HSET2_reg**: `0101 1101 0001 1---`+- **HSET2_cbuf**: `0111 110- 1--- ----`+- **HSET2_imm**: `0111 110- 0--- ----`++FP16 Compare And Set.++# HSETP2+- **HSETP2_reg**: `0101 1101 0010 0---`+- **HSETP2_cbuf**: `0111 111- 1--- ----`+- **HSETP2_imm**: `0111 111- 0--- ----`++FP16 Compare And Set Predicate.++# I2F+- **I2F_reg**: `0101 1100 1011 1---`+- **I2F_cbuf**: `0100 1100 1011 1---`+- **I2F_imm**: `0011 100- 1011 1---`++# I2I+- **I2I_reg**: `0101 1100 1110 0---`+- **I2I_cbuf**: `0100 1100 1110 0---`+- **I2I_imm**: `0011 100- 1110 0---`++# IADD+- **IADD_reg**: `0101 1100 0001 0---`+- **IADD_cbuf**: `0100 1100 0001 0---`+- **IADD_imm**: `0011 100- 0001 0---`++Integer Addition.++# IADD3+- **IADD3_reg**: `0101 1100 1100 ----`+- **IADD3_cbuf**: `0100 1100 1100 ----`+- **IADD3_imm**: `0011 100- 1100 ----`+- **IADD32I**: `0001 110- ---- ----`++3-input Integer Addition.++# ICMP+- **ICMP_reg**: `0101 1011 0100 ----`+- **ICMP_rc**: `0101 0011 0100 ----`+- **ICMP_cr**: `0100 1011 0100 ----`+- **ICMP_imm**: `0011 011- 0100 ----`++Integer Compare to Zero and Select Source.++# IDE+`1110 0011 1001 ----`++# IDP+- **IDP_reg**: `0101 0011 1111 1---`+- **IDP_imm**: `0101 0011 1101 1---`++# IMAD+- **IMAD_reg**: `0101 1010 0--- ----`+- **IMAD_rc**: `0101 0010 0--- ----`+- **IMAD_cr**: `0100 1010 0--- ----`+- **IMAD_imm**: `0011 010- 0--- ----`+- **IMAD32I**: `1000 00-- ---- ----`++Integer Multiply And Add.++# IMADSP+- **IMADSP_reg**: `0101 1010 1--- ----`+- **IMADSP_rc**: `0101 0010 1--- ----`+- **IMADSP_cr**: `0100 1010 1--- ----`+- **IMADSP_imm**: `0011 010- 1--- ----`++Extracted Integer Multiply And Add..++# IMNMX+- **IMNMX_reg**: `0101 1100 0010 0---`+- **IMNMX_cbuf**: `0100 1100 0010 0---`+- **IMNMX_imm**: `0011 100- 0010 0---`++Integer Minimum/Maximum.++# IMUL+- **IMUL_reg**: `0101 1100 0011 1---`+- **IMUL_cbuf**: `0100 1100 0011 1---`+- **IMUL_imm**: `0011 100- 0011 1---`+- **IMUL32I**: `0001 1111 ---- ----`++Integer Multiply.++# IPA+`1110 0000 ---- ----`++# ISBERD+`1110 1111 1101 0---`++In-Stage-Buffer Entry Read.++# ISCADD+- **ISCADD_reg**: `0101 1100 0001 1---`+- **ISCADD_cbuf**: `0100 1100 0001 1---`+- **ISCADD_imm**: `0011 100- 0001 1---`+- **ISCADD32I**: `0001 01-- ---- ----`++Scaled Integer Addition.++# ISET+- **ISET_reg**: `0101 1011 0101 ----`+- **ISET_cbuf**: `0100 1011 0101 ----`+- **ISET_imm**: `0011 011- 0101 ----`++Integer Compare And Set.++# ISETP+- **ISETP_reg**: `0101 1011 0110 ----`+- **ISETP_cbuf**: `0100 1011 0110 ----`+- **ISETP_imm**: `0011 011- 0110 ----`++Integer Compare And Set Predicate.++# JCAL+`1110 0010 0010 ----`++Absolute Call.++# JMP+`1110 0010 0001 ----`++Absolute Jump.++# JMX+`1110 0010 0000 ----`++Absolute Jump Indirect.++# KIL+`1110 0011 0011 ----`++# LD+`100- ---- ---- ----`++Load from generic Memory.++# LDC+`1110 1111 1001 0---`++Load Constant.++# LDG+`1110 1110 1101 0---`++Load from Global Memory.++# LDL+`1110 1111 0100 0---`++Load within Local Memory Window.++# LDS+`1110 1111 0100 1---`++Load within Shared Memory Window.++# LEA+- **LEA_hi_reg**: `0101 1011 1101 1---`+- **LEA_hi_cbuf**: `0001 10-- ---- ----`+- **LEA_lo_reg**: `0101 1011 1101 0---`+- **LEA_lo_cbuf**: `0100 1011 1101 ----`+- **LEA_lo_imm**: `0011 011- 1101 0---`++# LEPC+`0101 0000 1101 0---`++# LONGJMP+`1110 0011 0001 ----`++# LOP+- **LOP_reg**: `0101 1100 0100 0---`+- **LOP_cbuf**: `0100 1100 0100 0---`+- **LOP_imm**: `0011 100- 0100 0---`++# LOP3+- **LOP3_reg**: `0101 1011 1110 0---`+- **LOP3_cbuf**: `0000 001- ---- ----`+- **LOP3_imm**: `0011 11-- ---- ----`+- **LOP32I**: `0000 01-- ---- ----`++# MEMBAR+`1110 1111 1001 1---`++Memory Barrier.++# MOV+- **MOV_reg**: `0101 1100 1001 1---`+- **MOV_cbuf**: `0100 1100 1001 1---`+- **MOV_imm**: `0011 100- 1001 1---`+- **MOV32I**: `0000 0001 0000 ----`++# MUFU+`0101 0000 1000 0---`++Multi Function Operation.++# NOP+`0101 0000 1011 0---`++No operation.++# OUT+- **OUT_reg**: `1111 1011 1110 0---`+- **OUT_cbuf**: `1110 1011 1110 0---`+- **OUT_imm**: `1111 011- 1110 0---`++# P2R+- **P2R_reg**: `0101 1100 1110 1---`+- **P2R_cbuf**: `0100 1100 1110 1---`+- **P2R_imm**: `0011 1000 1110 1---`++Move Predicate Register To Register.++# PBK+`1110 0010 1010 ----`++Pre-break.++# PCNT+`1110 0010 1011 ----`++Pre-continue.++# PEXIT+`1110 0010 0011 ----`++Pre-exit.++# PIXLD+`1110 1111 1110 1---`++# PLONGJMP+`1110 0010 1000 ----`++Pre-long jump.++# POPC+- **POPC_reg**: `0101 1100 0000 1---`+- **POPC_cbuf**: `0100 1100 0000 1---`+- **POPC_imm**: `0011 100- 0000 1---`++Population/Bit count.++# PRET+`1110 0010 0111 ----`++Pre-return from subroutine. Pushes the return address to the CRS stack.++# PRMT+- **PRMT_reg**: `0101 1011 1100 ----`+- **PRMT_rc**: `0101 0011 1100 ----`+- **PRMT_cr**: `0100 1011 1100 ----`+- **PRMT_imm**: `0011 011- 1100 ----`++# PSET+`0101 0000 1000 1---`++Combine Predicates and Set.++# PSETP+`0101 0000 1001 0---`++Combine Predicates and Set Predicate.++# R2B+`1111 0000 1100 0---`++Move Register to Barrier.++# R2P+- **R2P_reg**: `0101 1100 1111 0---`+- **R2P_cbuf**: `0100 1100 1111 0---`+- **R2P_imm**: `0011 100- 1111 0---`++Move Register To Predicate/CC Register.++# RAM+`1110 0011 1000 ----`++# RED+`1110 1011 1111 1---`++Reduction Operation on Generic Memory.++# RET+`1110 0011 0010 ----`++Return.++# RRO+- **RRO_reg**: `0101 1100 1001 0---`+- **RRO_cbuf**: `0100 1100 1001 0---`+- **RRO_imm**: `0011 100- 1001 0---`++# RTT+`1110 0011 0110 ----`++# S2R+`1111 0000 1100 1---`++# SAM+`1110 0011 0111 ----`++# SEL+- **SEL_reg**: `0101 1100 1010 0---`+- **SEL_cbuf**: `0100 1100 1010 0---`+- **SEL_imm**: `0011 100- 1010 0---`++# SETCRSPTR+`1110 0010 1110 ----`++# SETLMEMBASE+`1110 0010 1111 ----`++# SHF+- **SHF_l_reg**: `0101 1011 1111 1---`+- **SHF_l_imm**: `0011 011- 1111 1---`+- **SHF_r_reg**: `0101 1100 1111 1---`+- **SHF_r_imm**: `0011 100- 1111 1---`++# SHFL+`1110 1111 0001 0---`++# SHL+- **SHL_reg**: `0101 1100 0100 1---`+- **SHL_cbuf**: `0100 1100 0100 1---`+- **SHL_imm**: `0011 100- 0100 1---`++# SHR+- **SHR_reg**: `0101 1100 0010 1---`+- **SHR_cbuf**: `0100 1100 0010 1---`+- **SHR_imm**: `0011 100- 0010 1---`++# SSY+`1110 0010 1001 ----`++Set Synchronization Point.++# ST+`101- ---- ---- ----`++Store to generic Memory.++# STG+`1110 1110 1101 1---`++Store to global Memory.++# STL+`1110 1111 0101 0---`++Store within Local or Shared Window.++# STP+`1110 1110 1010 0---`++Store to generic Memory and Predicate.++# STS+`1110 1111 0101 1---`++Store within Local or Shared Window.++# SUATOM+- **SUATOM**: `1110 1010 0--- ----`+- **SUATOM_cas**: `1110 1010 1--- ----`++Atomic Op on Surface Memory.++# SULD+`1110 1011 000- ----`++Surface Load.++# SURED+`1110 1011 010- ----`++Reduction Op on Surface Memory.++# SUST+`1110 1011 001- ----`++Surface Store.++# SYNC+`1111 0000 1111 1---`++# TEX+- **TEX**: `1100 0--- ---- ----`+- **TEX_b**: `1101 1110 10-- ----`+- **TEXS**: `1101 -00- ---- ----`++Texture Fetch with scalar/non-vec4 source/destinations.++# TLD+- **TLD**: `1101 1100 ---- ----`+- **TLD_b**: `1101 1101 ---- ----`+- **TLDS**: `1101 -01- ---- ----`++Texture Load with scalar/non-vec4 source/destinations.++# TLD4+- **TLD4**: `1100 10-- ---- ----`+- **TLD4_b**: `1101 1110 11-- ----`+- **TLD4S**: `1101 1111 -0-- ----`++Texture Load 4 with scalar/non-vec4 source/destinations.++# TMML+- **TMML**: `1101 1111 0101 1---`+- **TMML_b**: `1101 1111 0110 0---`++Texture MipMap Level.++# TXA+`1101 1111 0100 0---`++# TXD+- **TXD**: `1101 1110 00-- ----`+- **TXD_b**: `1101 1110 01-- ----`++Texture Fetch With Derivatives.++# TXQ+- **TXQ**: `1101 1111 0100 1---`+- **TXQ_b**: `1101 1111 0101 0---`++Texture Query.++# VABSDIFF+`0101 0100 ---- ----`++# VABSDIFF4+`0101 0000 0--- ----`++# VADD+`0010 00-- ---- ----`++# VMAD+`0101 1111 ---- ----`++# VMNMX+`0011 101- ---- ----`++# VOTE+- **VOTE**: `0101 0000 1101 1---`+- **VOTE_vtg**: `0101 0000 1110 0---`++Vote Across SIMD Thread Group++# VSET+`0100 000- ---- ----`++# VSETP+`0101 0000 1111 0---`++# VSHL+`0101 0111 ---- ----`++# VSHR+`0101 0110 ---- ----`++# XMAD+- **XMAD_reg**: `0101 1011 00-- ----`+- **XMAD_rc**: `0101 0001 0--- ----`+- **XMAD_cr**: `0100 111- ---- ----`+- **XMAD_imm**: `0011 011- 00-- ----`++Integer Short Multiply Add.diff --git a/docs/README.md b/docs/README.mdindex 5a52315fcc..5df8293734 100644--- a/docs/README.md+++ b/docs/README.md@@ -10,4 +10,6 @@ This contains documentation created by developers. This contains build instructi- **[Debug Guidelines](./Debug.md)**- **[CPM - CMake Package Manager](CPMUtil.md)**- **[Platform-Specific Caveats](Caveats.md)**+- **[The NVIDIA SM86 (Maxwell) GPU](./NvidiaGpu.md)**- **[User Handbook](./user)**+- **[Release Policy](./ReleasePolicy.md)**diff --git a/docs/ReleasePolicy.md b/docs/ReleasePolicy.mdnew file mode 100644index 0000000000..65a4cebc20--- /dev/null+++ b/docs/ReleasePolicy.md@@ -0,0 +1,25 @@+# Release Policy++While releases are usually made at the discretion of the team, we feel that establishing a clearer guideline on how those come to be will help expectations when it comes to features and fixes per version.++## Release candidates++Every full release is *preceded* by at least, 3 release candidates. The reasoning is that each week of the month, there will be a release candidate, with the "4th one" being the final full release.++The main expectation is that the release candidates bring both fixes and, sometimes, new features. But not guarantee a regression-free experience.++The criteria for choosing a date for a release candidate is at discretion, or "perceived necesity" at any given time.++## Full release++A full release means there are *no major* leftover regressions, importantly this means that a grand portion of regressions found between release candidates are swept out before declaring a full release. This doesn't mean a full release is regression-free; but we do a best-effort approach to reduce them for end-users.++The main expectation is that users can safely upgrade from a stable build to another, with no major regressions.++## Snapshot/rolling release++While we don't publish rolling releases, we are aware users may compile from source and/or provide binaries to master builds of the project.++This is mostly fine since we keep master very stable from major hiccups. However sometimes bugs do slip between tests or reviews - so users are advised to keep that in mind.++We advise that users also read git logs (`git log --oneline`) before recompiling to get a clearer picture of the changes given into the emulator.diff --git a/docs/user/AddEdenToSRM_SteamDeck.md b/docs/user/AddEdenToSRM.mdsimilarity index 100%rename from docs/user/AddEdenToSRM_SteamDeck.mdrename to docs/user/AddEdenToSRM.mddiff --git a/docs/user/AddGamesToSRM_SteamDeck.md b/docs/user/AddGamesToSRM.mdsimilarity index 100%rename from docs/user/AddGamesToSRM_SteamDeck.mdrename to docs/user/AddGamesToSRM.mddiff --git a/docs/user/AlterDate-Time.md b/docs/user/AlterDateTime.mdsimilarity index 100%rename from docs/user/AlterDate-Time.mdrename to docs/user/AlterDateTime.mddiff --git a/docs/user/ControllerProfileByGame.md b/docs/user/ControllerProfileByGame.mddeleted file mode 100644index 3bc1a31263..0000000000--- a/docs/user/ControllerProfileByGame.md+++ /dev/null@@ -1,28 +0,0 @@-# Setting Controller Profiles By Game--Use this guide when you want to set up specific controller profiles for specific games. This can be useful for certain games like *Captain Toad Treasure Tracker* where a blue dot appears in the middle of the screen when you have docked mode enabled, but not handheld mode.--**Click [Here](https://evilperson1337.notion.site/Setting-Controller-Profiles-By-Game-2b057c2edaf681658a57f0c199cb6083) for a version of this guide with images & visual elements.**-------### Pre-Requisites--- Eden Emulator set up and fully configured-- Controller Profile Created- - See [*Configuring Controller Profiles*](./ControllerProfiles.md) for instructions on how to do this if needed.-------## Steps--1. *Right-Click* the game you want to apply the profile to in the main window and select **Properties.**-2. Navigate to the **Input Profiles** tab in the window that appears. Drop down on *Player 1 profile* (or whatever player profile you want to apply it to) and select the profile you want.-- <aside>-- ***NOTE***: You may have to resize the window to see all tabs, or press the arrows by the tabs to see **Input Profiles**.-- </aside>-1. Click **OK** to apply the profile mapping.-2. Launch the game and confirm that the profile is applied, regardless of what the global configuration is.\ No newline at end of filediff --git a/docs/user/ControllerProfiles.md b/docs/user/ControllerProfiles.mdindex c9a232f730..3b4898f447 100644--- a/docs/user/ControllerProfiles.md+++ b/docs/user/ControllerProfiles.md@@ -12,9 +12,38 @@ Use this guide for when you want to configure specific controller settings to be----## Steps+### Steps1. Launch Eden and wait for it to load.2. Navigate to *Emulation > Configure…*3. Select **Controls** from the left-hand menu and configure your controller for the way you want it to be in game.4. Select **New** and enter a name for the profile in the box that appears. Press **OK** to save the profile settings.-5. Select **OK** to close the settings menu.\ No newline at end of file+5. Select **OK** to close the settings menu.++## Setting Controller Profiles By Game++Use this guide when you want to set up specific controller profiles for specific games. This can be useful for certain games like *Captain Toad Treasure Tracker* where a blue dot appears in the middle of the screen when you have docked mode enabled, but not handheld mode.++**Click [Here](https://evilperson1337.notion.site/Setting-Controller-Profiles-By-Game-2b057c2edaf681658a57f0c199cb6083) for a version of this guide with images & visual elements.**++---++### Pre-Requisites++- Eden Emulator set up and fully configured+- Controller Profile Created+ - See [*Configuring Controller Profiles*](./ControllerProfiles.md) for instructions on how to do this if needed.++---++### Steps++1. *Right-Click* the game you want to apply the profile to in the main window and select **Properties.**+2. Navigate to the **Input Profiles** tab in the window that appears. Drop down on *Player 1 profile* (or whatever player profile you want to apply it to) and select the profile you want.++ <aside>++ ***NOTE***: You may have to resize the window to see all tabs, or press the arrows by the tabs to see **Input Profiles**.++ </aside>+1. Click **OK** to apply the profile mapping.+2. Launch the game and confirm that the profile is applied, regardless of what the global configuration is.diff --git a/docs/user/Graphics.md b/docs/user/Graphics.mdindex 7100030ade..e1e13a777d 100644--- a/docs/user/Graphics.md+++ b/docs/user/Graphics.md@@ -90,3 +90,22 @@ The OpenGL backend would invoke behaviour that would result in swarst/LLVMpipe w### HaikuOS compatibilityHaikuOS bundles a Mesa library that doesn't support full core OpenGL 4.6 (required by the emulator). This leads to HaikuOS being one of the few computer platforms where Vulkan is the only available option for users. If OpenGL is desired, Mesa has to be built manually from source. For debugging purpouses `lavapipe` is recommended over the GPU driver; there is in-kernel support for NVIDIA cards through.++### Fixes for Windows 10 and above having "Device loss"++Run the following batch script *inside* the Eden folder:+```cmd+@echo off+pushd "%~dp0"+if exist "%temp%\FixFullScreen.reg" (+ del %temp%\FixFullScreen.reg+)+set str_path="%cd:\=\\%\\eden.exe"+echo Windows Registry Editor Version 5.00 >> %temp%\FixFullScreen.reg+echo. >> %temp%\FixFullScreen.reg+echo [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\AppCompatFlags\Layers] >> %temp%\FixFullScreen.reg+echo %str_path%="~ DISABLEDXMAXIMIZEDWINDOWEDMODE HIGHDPIAWARE" >> %temp%\FixFullScreen.reg+regedit /s %temp%\FixFullScreen.reg+del %temp%\FixFullScreen.reg+exit /b+```diff --git a/docs/user/GyroControls_SteamDeck.md b/docs/user/GyroControls.mdsimilarity index 97%rename from docs/user/GyroControls_SteamDeck.mdrename to docs/user/GyroControls.mdindex 2a98e676ec..0df9088c1e 100644--- a/docs/user/GyroControls_SteamDeck.md+++ b/docs/user/GyroControls.md@@ -3,7 +3,7 @@ Use this guide when you want to use the Steam Deck's native gyro functionality f**Click [Here](https://evilperson1337.notion.site/Getting-Gyro-Motion-Controls-Working-on-Steam-Deck-2b057c2edaf681a1aaade35db6e0fd1b) for a version of this guide with images & visual elements.**----+## Steamdeck### Pre-Requisites@@ -13,7 +13,7 @@ Use this guide when you want to use the Steam Deck's native gyro functionality f----## Steps+### Steps1. Go into Steam Deck's Desktop Mode, and use the shortcut to launch EmuDeck.2. Install [SteamDeckGyroDSU](https://github.com/kmicki/SteamDeckGyroDSU/releases) by going to *3rd Party Tools > Gyroscope* and clicking **Install.**diff --git a/docs/user/ImportingSaves_Windows.md b/docs/user/ImportingSaves.mdsimilarity index 92%rename from docs/user/ImportingSaves_Windows.mdrename to docs/user/ImportingSaves.mdindex 1827a6d6b7..428609f69c 100644--- a/docs/user/ImportingSaves_Windows.md+++ b/docs/user/ImportingSaves.md@@ -4,15 +4,13 @@ Use this guide when you want to manually import save files for use in the Eden e**Click [Here](https://evilperson1337.notion.site/Importing-Saves-Into-Eden-2b057c2edaf681fe968df8d63821ccae) for a version of this guide with images & visual elements.**-----### Pre-Requisites- Eden emulator already set up and configured.- The save file(s) you want to import----+## Desktop-## Steps+### Steps1. Open Eden and wait for it to load.2. Start the game and create a save file to establish the directories.3. *Right-Click* the game for which you want to load a save in.@@ -25,4 +23,8 @@ Use this guide when you want to manually import save files for use in the Eden e</aside>7. Close the file explorer as it is no longer needed.-8. Launch the game in Eden and verify that the save data appears through whatever method the game implements.\ No newline at end of file+8. Launch the game in Eden and verify that the save data appears through whatever method the game implements.++## Android++TBDdiff --git a/docs/user/InstallingAtmosphereMods.md b/docs/user/InstallingAtmosphereMods.mdindex 77eeea6080..ae8e4b37d2 100644--- a/docs/user/InstallingAtmosphereMods.md+++ b/docs/user/InstallingAtmosphereMods.md@@ -1,4 +1,4 @@-# Installing Atmosphere Mods+# User Handbook - Installing Atmosphere ModsUse this guide for when you want to install an Atmosphere-based mod for use in Eden.diff --git a/docs/user/InstallingUpdates-DLC.md b/docs/user/InstallingUpdatesDLC.mdsimilarity index 96%rename from docs/user/InstallingUpdates-DLC.mdrename to docs/user/InstallingUpdatesDLC.mdindex 6cb0099d85..2fdf40dde9 100644--- a/docs/user/InstallingUpdates-DLC.md+++ b/docs/user/InstallingUpdatesDLC.md@@ -1,4 +1,4 @@-# Working with Updates/DLC in Eden+# User Handbook - Working with Updates/DLC in EdenUse this guide when you want to install Updates or DLC for your games in Eden.diff --git a/docs/user/QuickStart_Windows.md b/docs/user/QuickStart.mdsimilarity index 56%rename from docs/user/QuickStart_Windows.mdrename to docs/user/QuickStart.mdindex 9b90f622ce..c7e7f566d6 100644--- a/docs/user/QuickStart_Windows.md+++ b/docs/user/QuickStart.md@@ -4,21 +4,18 @@ Use this guide to get starting using the Eden emulator.**Click [Here](https://evilperson1337.notion.site/Eden-Quick-Start-2b057c2edaf6817b9859d8bcdb474017) for a version of this guide with images & visual elements.**----+## Windows### Pre-Requisites-- The [*latest C++ Redistributable*](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170#latest-supported-redistributable-version) from Microsoft.- - Eden will not even launch without it see [*Eden Fails to Launch*](./EdenFailsToLaunch.md) for more information.+ - Eden will not even launch without it see [*Eden Fails to Launch*](./Troubleshoot.md) for more information.- Firmware dumped from your console- Keys extracted from your console- Games dumped from your console- Internet Connection------## Steps+### Steps1. Download either the *Stable* or *Nightly* Eden application.<aside>@@ -44,4 +41,39 @@ Use this guide to get starting using the Eden emulator.6. Navigate to **Tools → Install Firmware**, *Select **From Folder*** or ***From ZIP*** - depending on how your firmware is stored, navigate to where it is stored and select it.7. Double-Click the main window to add the folder containing your games.8. Go to *Emulation > Configure > Input* and set up your controller of choice. Click **OK** to close the dialog window.-9. Double-Click a game to run it.\ No newline at end of file+9. Double-Click a game to run it.++## Steamdeck++### Pre-Requisites++- Firmware dumped from your console+- Keys extracted from your console+- Games dumped from your console+- Internet Connection++### Steps++1. Access Steam Desktop Mode.+2. Download either the *Stable* or *Nightly* Eden AppImage onto your Steam Deck and save it somewhere accessible.++ <aside>++ ***TIP***: If you have questions about the requirements, architectures, or general information surrounding what release you need - see the [*Basics Guide*](./Basics.md) and [*Architectures Guide*](./Architectures.md).++ </aside>++3. Double-Click the Eden executable to launch the program.+ <aside>++ ***NOTE***: The first time you run the AppImage you will get a notification asking you to confirm you want to launch the program. Hit **Continue**.++ </aside>++4. If you have had a different Switch emulator installed, it will detect and ask if you want to import those settings. Make your selection to close the screen.+5. Eden will now launch and notify you about missing Encryption keys. Close the dialog box by hitting **OK**.+6. Navigate to **Tools → Install Decryption Keys**, navigate to the folder containing your ***prod.keys*** file and select the file and hit **Open**.+7. Navigate to **Tools → Install Firmware →** *Select **From Folder*** or ***From ZIP*** - depending on how your firmware is stored, navigate to where it is stored and select it.+8. Double-Click the main window to add the folder containing your games.+9. Go to *Emulation > Configure > Input* and set up your controller. Click **OK** to close the dialog window.+10. Double-Click a game to run it.diff --git a/docs/user/QuickStart_SteamDeck.md b/docs/user/QuickStart_SteamDeck.mddeleted file mode 100644index e43bc2cce9..0000000000--- a/docs/user/QuickStart_SteamDeck.md+++ /dev/null@@ -1,42 +0,0 @@-# Eden Quick Start--Use this guide to get starting using the Eden emulator on Steam Deck.--**Click [Here](https://evilperson1337.notion.site/Eden-Quick-Start-2b757c2edaf680d49ffdcda291a32840) for a version of this guide with images & visual elements.**-------### Pre-Requisites--- Firmware dumped from your console-- Keys extracted from your console-- Games dumped from your console-- Internet Connection-------## Steps--1. Access Steam Desktop Mode.-2. Download either the *Stable* or *Nightly* Eden AppImage onto your Steam Deck and save it somewhere accessible.-- <aside>-- ***TIP***: If you have questions about the requirements, architectures, or general information surrounding what release you need - see the [*Basics Guide*](./Basics.md) and [*Architectures Guide*](./Architectures.md).-- </aside>--3. Double-Click the Eden executable to launch the program.- <aside>-- ***NOTE***: The first time you run the AppImage you will get a notification asking you to confirm you want to launch the program. Hit **Continue**.-- </aside>--4. If you have had a different Switch emulator installed, it will detect and ask if you want to import those settings. Make your selection to close the screen.-5. Eden will now launch and notify you about missing Encryption keys. Close the dialog box by hitting **OK**.-6. Navigate to **Tools → Install Decryption Keys**, navigate to the folder containing your ***prod.keys*** file and select the file and hit **Open**.-7. Navigate to **Tools → Install Firmware →** *Select **From Folder*** or ***From ZIP*** - depending on how your firmware is stored, navigate to where it is stored and select it.-8. Double-Click the main window to add the folder containing your games.-9. Go to *Emulation > Configure > Input* and set up your controller. Click **OK** to close the dialog window.-10. Double-Click a game to run it.\ No newline at end of filediff --git a/docs/user/README.md b/docs/user/README.mdindex 4de6713f5c..5fd3a17e51 100644--- a/docs/user/README.md+++ b/docs/user/README.md@@ -4,14 +4,35 @@ The "FAQ".This handbook is primarily aimed at the end-user - baking useful knowledge for enhancing their emulation experience.+## Basics+- **[The Basics](Basics.md)**+- **[Quickstart](./QuickStart.md)**+- **[Run On macOS](./RunOnMacOS.md)**- **[Audio](Audio.md)**-- **[Server hosting](ServerHosting.md)**- **[Graphics](Graphics.md)**-- **[Platforms and Architectures](Architectures.md)**-- **[Testing](Testing.md)**-- **[Data, savefiles and storage](Storage.md)**+- **[Data, Savefiles and Storage](Storage.md)**- **[Orphaned Profiles](Orphaned.md)**+- **[Troubleshooting](./Troubleshoot.md)**+- **[Using Amiibo](./UsingAmiibo.md)**+- **[Using Cheats](./UsingCheats.md)**+- **[Importing Saves](./ImportingSaves.md)**+- **[Add Eden to Steam ROM Manager](./AddEdenToSRM.md)**+- **[Add Games to Steam ROM Manager](./AddGamesToSRM.md)**+- **[Installing Atmosphere Mods](./InstallingAtmosphereMods.md)**+- **[Installing Updates & DLCs](./InstallingUpdatesDLC.md)**+- **[Controller Profiles](./ControllerProfiles.md)**+- **[Alter Date & Time](./AlterDateTime.md)**++## Advanced++- **[How To Access Logs](./HowToAccessLogs.md)**+- **[Gyro Controls](./GyroControls.md)**+- **[Platforms and Architectures](Architectures.md)**+- **[Server hosting](ServerHosting.md)**- **[Command Line](CommandLine.md)**- **[Native Application Development](Native.md)**- **[Adding Boolean Settings Toggles](AddingBooleanToggles.md)**+- **[Adding Debug Knobs](./AddingDebugKnobs.md)**+- **[Syncthing Guide](./SyncthingGuide.md)**+- **[Testing](Testing.md)**diff --git a/docs/user/RunOnMacOS_MacOS.md b/docs/user/RunOnMacOS.mdsimilarity index 100%rename from docs/user/RunOnMacOS_MacOS.mdrename to docs/user/RunOnMacOS.mddiff --git a/docs/user/SyncthingGuide.md b/docs/user/SyncthingGuide.mdnew file mode 100644index 0000000000..21b4d2acce--- /dev/null+++ b/docs/user/SyncthingGuide.md@@ -0,0 +1,211 @@+# User Handbook - Backing Up/Syncing Eden Game Saves++Use this guide for when you want to configure automated backup/syncing of your Eden save files using [*Syncthing*](https://syncthing.net/).++**Click [Here](https://evilperson1337.notion.site/Backing-Up-Syncing-Eden-Game-Saves-2b357c2edaf68000b40cfab2c2c3dc0a) for a version of this guide with images & visual elements.**++### Pre-Requisites++- Eden already installed, configured, and functioning.+- Devices to run Syncthing on.+- Ability to allow a program to communicate through the firewall of your device.++## Introduction++<aside>++***WARNING***: You should manually back up your save files before proceeding with this guide. If you incorrectly perform the steps, you risk losing them!++</aside>++- While this is a de-centralized model without the concepts of a Server/Client, Parent/Child, etc. - For the purposes of these guides, we will borrow from this models terminology to avoid sync conflicts and potential data loss. After the initial setup, all the devices in the sync network are equals and can push & pull files from any other device.+- In order for this to work, you should get all of the save files in Eden in the save folder on the Parent.+ - If you need help doing that, see the ***Importing Saves into Eden*** guide for the platform you elect to act as the Parent, and delete the save files on the "Child" devices.++### Terminology++- **Sync Network**: All the devices configured in *Syncthing* to push/pull files.+- **Parent**: This will be the device that you elect to push files to the other devices. There can only be one here initially in order to avoid sync conflicts.+- **Child**: All the other devices added to the Sync Network. These devices will pull files from the Parent.++## Overview++Rather than giving a breakdown of all the platforms and configurations, those will be in the platform’s specific guides - this will serve as a general overview of Syncthing.++### What is Syncthing Anyway?++Syncthing is a continuous file synchronization program (in the layman’s - make sure 2 or more systems with the same files are always up to date). This is perfect for game saves where we would want to play on 1 device, save our game, and then continue playing it on another device. This technology is what Epic/Steam/etc. use to allow you to do this on games run through their respective services. Syncthing is an open source implementation of this technology that you control, rather than relying on a 3rd party. This has a few key benefits, most notably - better security, privacy, and speed (when on your LAN).++### What are some common issues?++Syncthing is fairly robust and doesn’t have many issues luckily, but there are some things you should watch out for (almost all of them a user issue).++- Sync conflicts+ - If for whatever reason you update the same file on 2 different machines, the system does not know which updated file is considered the one to sync across. This results in a ***sync conflict*** where it may not sync the files as you would expect. Worst case scenario, this can result in your save progress being lost if you are not careful. When one of these occurs, it will create a copy of the file and store it with a specific name, like this example, *Paper Mario.sync-conflict-20251102-072925-TZBBN6S.srm.* To resolve this, you must remove the other files and remove the *.sync-conflict-<TIMESTAMP>-<Syncthing Device ID>* from the file name of the file you want to keep.+- Accidental Deletions+ - If you delete a file from one of the devices, it will also remove the file on the other devices when they perform a sync so be careful when doing this.++## Windows++### Pre-Requisites++- Eden already installed, configured, and functioning.+- Ability to allow a program to communicate through the firewall in Windows.+- Ability to extract archive (.zip/.7z/.rar) files.++### Steps++<aside>++***WARNING***: You should manually back up your save files before proceeding with this guide. If you incorrectly perform the steps, you risk losing them!++</aside>++#### Downloading and Installing *Syncthing*++1. Download [*Syncthing Tray*](https://martchus.github.io/syncthingtray/#downloads-section).+ 1. While it is available as a command line interface, for most people I would recommend *Syncthing Tray* on Windows. For most people here, you would download the **64-bit (Intel/AMD)** version.+2. Open the downloaded archive and extract the **syncthingtray.exe** to wherever you want to store the executable.+3. Double-Click the application to run it, select the **Start guided setup** on the splash screen that appears and press **Next**.++ <aside>++ ***NOTE***: You may get a Windows Defender Smart Screen pop up, this is a known thing, just accept and run anyway.++ </aside>+4. It will then look for an existing Syncthing instance to pull settings from, but will likely fail to do so if you are here. Regardless, select the **Yes, continue configuration** option.+5. Select ***Start Syncthing application that is built into Syncthing Tray***, this means it will use a built in Syncthing executable rather than relying on an externally provided one. Press **Next** to continue.+6. Check the box to start Syncthing Tray on login - as the name implies, this means the program will run automatically whenever you log onto the computer. Press Next to continue.+7. You will now be presented with a confirmation window with your selections, confirm they are what you want and hit **Apply** to continue.+8. You will now be prompted with a confirmation window and a message to allow it through the firewall. Allow the access through the firewall to close that pop up. The confirmation screen has a QR code and the devices identifier - you will need one of these to add other devices to the sync system.+9. *Syncthing/Syncthing Tray* are now installed.++#### Configuring this Machine as a Parent++Use this when you want to set this machine as the initial source of truth (push files out to all the other devices). Afterwards they will all be equal partners, not a parent/child relationship, this just helps with initial setup.++1. Right-Click the *Syncthing* Tray icon in your taskbar and select **Open Syncthing.**+2. You will now have a browser window open up to a web GUI to configure *Syncthing*. You will get a pop up about allowing anonymous usage and setting a password, make your selections to close them.+3. We’ll start by adding the folder with our save files that we want to sync by Pressing **+ Add Folder**.+4. A pop-up window will appear, fill in the Folder label field with whatever you want to call it, like Switch Saves.+5. Enter the Full folder path to where your save files are stored on this machine.++ <aside>++ ***TIP***: The easiest way to do this would be to open Eden, right-click a game that has a save, hit ***Open Save Data Location,*** and then go up 1 directory. It should contain folders with the TitleID of your games.++ It should look similar to this: ..*\nand\user\save\0000000000000000\EC573727F509799675F6E5112C581D7E*++ </aside>++6. Ignore the other tabs for now and hit **Save**.+7. The folder is now ready to be shared with other devices.++#### Configuring this Machine as a Child++Use this when you want to set this machine up as a child (pull files from the other devices). Afterwards they will all be equal partners, not a parent/child relationship, this just helps with initial setup.++1. Install Syncthing Tray on the client device following the section above. Copy the child’s ID and store it so it is accessible to the Parent.+2. ***ON THE PARENT***: Right-Click the *Syncthing* Tray icon in your taskbar and select **Open Syncthing** if it is not open already**.**+3. You will now have a browser window open up to a web GUI to configure *Syncthing*. You will get a pop up about allowing anonymous usage and setting a password, make your selections to close them.+4. Navigate down to **+ Add Remote Device**, we are going to add our Child device, so I hope you have its ID handy. If not, go back and get it.+5. Add the ID and Name the device, the device may appear as a **nearby device**, in which case you can just click it to pre-populate the Device ID.+6. Click the **Sharing** Tab, and check the box next to the folder you set up on the Parent (Switch Saves in my case). Hit **Save.**+7. We are done with the parent, now **SWITCH OVER TO THE CHILD.**+8. ***ON THE CHILD***: Right-Click the *Syncthing* Tray icon in your taskbar and select **Open Syncthing** if it is not open already**.**+9. You should now see a connection request from the parent. Hit **+ Add Device** to add the device.+10. Hit **Save** to finish adding the device.+11. That pop-up will close and you will get notification that the device wants to share a folder now. Hit **Add.**+12. Enter the path to the save folder in Eden and hit **Save.**++ <aside>++ ***TIP***: The easiest way to do this would be to open Eden, right-click a game that has a save, hit ***Open Save Data Location,*** and then go up 1 directory. It should contain folders with the TitleID of your games.++ It should look similar to this: ..*\nand\user\save\0000000000000000\EC573727F509799675F6E5112C581D7E*++ </aside>++13. *Syncthing* will now pull all the files from the Parent and store them in your local save directory. At this point the files are in sync and alterations to one will affect the other and both can be considered “*Parents*” for other devices you want to add. Repeat these steps for as many devices you want.++## Linux++### Pre-Requisites++- Eden already installed, configured, and functioning.++### Step 1: Downloading and Installing Syncthing++<aside>++***WARNING***: You should manually back up your save files before proceeding with this guide. If you incorrectly perform the steps, you risk losing them!++</aside>++<aside>++***NOTE***: I am using Linux Mint for my guides, but the steps should translate pretty easily to your distro. I ***hope*** that if you are running Linux you know the basic operations. Steam Deck users should follow the guide specific to that platform.++</aside>++1. Download [*Syncthing Tray*](https://flathub.org/en/apps/io.github.martchus.syncthingtray) from the Flatpak store.+2. Launch *Syncthing Tray* to run it, select the **Start guided setup** on the splash screen that appears and press **Next**.+3. It will then look for an existing *Syncthing* instance to pull settings from, but will likely fail to do so if you are here. Regardless, select the **Yes, continue configuration** option.+4. Select ***Start installed Syncthing application via Syncthing Tray***, this means it will use a built in Syncthing executable rather than relying on an externally provided one. Press **Next** to continue.+5. You will now be presented with a confirmation window with your selections, confirm they are what you want and hit **Apply** to continue.+6. You will now be prompted with a confirmation window that has a QR code and the devices identifier - you will need one of these to add other devices to the sync system.+7. *Syncthing/Syncthing Tray* are now installed. Press Finish to close the pop up.+ <aside>++ ***NOTE***: By default due to flatpak sandboxing limitations, Syncthing Tray will not run automatically on login. You can get around this by following the [*instructions here*](https://github.com/flathub/io.github.martchus.syncthingtray).++ </aside>++### Step 2: Configuring this Machine as a Parent++Use this when you want to set this machine as the initial source of truth (push files out to all the other devices). Afterwards they will all be equal partners, not a parent/child relationship, this just helps with initial setup.++1. Right-Click the *Syncthing* Tray icon in your taskbar and select **Open Syncthing.**+ 1. If you don’t have a taskbar in your distro, you can also reach it directly by opening a web browser to: *http://127.0.0.1:8384/.*+2. You will now have a browser window open up to a web GUI to configure *Syncthing*. You will get a pop up about allowing anonymous usage and setting a password, make your selections to close them.+3. We’ll start by adding the folder with our save files that we want to sync by Pressing **+ Add Folder**.+4. A pop-up window will appear, fill in the Folder label field with whatever you want to call it, like Switch Saves.+5. Enter the Full folder path to where your save files are stored on this machine.++ <aside>++ ***TIP***: The easiest way to do this would be to open Eden, right-click a game that has a save, hit ***Open Save Data Location,*** and then go up 1 directory. It should contain folders with the TitleID of your games.++ It should look similar to this: ..*\nand\user\save\0000000000000000\EC573727F509799675F6E5112C581D7E*++ </aside>++6. Ignore the other tabs for now and hit **Save**.+7. The folder is now ready to be shared with other devices.++### Step 3: Configuring this Machine as a Child++Use this when you want to set this machine up as a child (pull files from the other devices). Afterwards they will all be equal partners, not a parent/child relationship, this just helps with initial setup.++1. Install Syncthing Tray on the client device following the section above. Copy the child’s ID and store it so it is accessible to the Parent.+2. ***ON THE PARENT***: Right-Click the *Syncthing* Tray icon in your taskbar and select **Open Syncthing** if it is not open already**.**+3. You will now have a browser window open up to a web GUI to configure *Syncthing*. You will get a pop up about allowing anonymous usage and setting a password, make your selections to close them.+4. Navigate down to **+ Add Remote Device**, we are going to add our Child device, so I hope you have its ID handy. If not, go back and get it.+5. Add the ID and Name the device, the device may appear as a **nearby device**, in which case you can just click it to pre-populate the Device ID.+6. Click the **Sharing** Tab, and check the box next to the folder you set up on the Parent (Switch Saves in my case). Hit **Save.**+7. We are done with the parent, now **SWITCH OVER TO THE CHILD.**+8. ***ON THE CHILD***: Right-Click the *Syncthing* Tray icon in your taskbar and select **Open Syncthing** if it is not open already.+9. You should now see a connection request pop-up from the parent. Hit **+ Add Device** to add the device.+10. Hit **Save** to finish adding the device.+11. That pop-up will close and you will get notification that the device wants to share a folder now. Hit **Add.**+12. Enter the path to the save folder in Eden and hit **Save.**++ <aside>++ ***TIP***: The easiest way to do this would be to open Eden, right-click a game that has a save, hit ***Open Save Data Location,*** and then go up 1 directory. It should contain folders with the TitleID of your games.++ It should look similar to this: ..*\nand\user\save\0000000000000000\EC573727F509799675F6E5112C581D7E*++ </aside>++13. *Syncthing* will now pull all the files from the Parent and store them in your local save directory. At this point the files are in sync and alterations to one will affect the other and both can be considered “*Parents*” for other devices you want to add. Repeat these steps for as many devices you want.diff --git a/docs/user/SyncthingGuide_General.md b/docs/user/SyncthingGuide_General.mddeleted file mode 100644index 1ae9d13a05..0000000000--- a/docs/user/SyncthingGuide_General.md+++ /dev/null@@ -1,66 +0,0 @@-# Backing Up/Syncing Eden Game Saves--Use this guide for when you want to configure automated backup/syncing of your Eden save files using [*Syncthing*](https://syncthing.net/).--**Click [Here](https://evilperson1337.notion.site/Backing-Up-Syncing-Eden-Game-Saves-2b357c2edaf68000b40cfab2c2c3dc0a) for a version of this guide with images & visual elements.**-------### Pre-Requisites--- Eden already installed, configured, and functioning.-- Devices to run Syncthing on.-- Ability to allow a program to communicate through the firewall of your device.-------## Platform Specific Setup Guides--- [*Windows*](./SyncthingGuide_Windows.md)-- *MacOS (Coming Soon)*-- *Steam Deck (Coming Soon)*-- *Android (Coming Soon)*-- [*Linux*](./SyncthingGuide_Linux.md)-------## A Few Notes Before You Proceed--<aside>--***WARNING***: You should manually back up your save files before proceeding with this guide. If you incorrectly perform the steps, you risk losing them!--</aside>--- While this is a de-centralized model without the concepts of a Server/Client, Parent/Child, etc. - For the purposes of these guides, we will borrow from this models terminology to avoid sync conflicts and potential data loss. After the initial setup, all the devices in the sync network are equals and can push & pull files from any other device.-- In order for this to work, you should get all of the save files in Eden in the save folder on the Parent.- - If you need help doing that, see the ***Importing Saves into Eden*** guide for the platform you elect to act as the Parent, and delete the save files on the "Child" devices.--### Terminology--- **Sync Network**: All the devices configured in *Syncthing* to push/pull files.-- **Parent**: This will be the device that you elect to push files to the other devices. There can only be one here initially in order to avoid sync conflicts.-- **Child**: All the other devices added to the Sync Network. These devices will pull files from the Parent.-------## Overview--Rather than giving a breakdown of all the platforms and configurations, those will be in the platform’s specific guides - this will serve as a general overview of Syncthing.-------### What is Syncthing Anyway?--Syncthing is a continuous file synchronization program (in the layman’s - make sure 2 or more systems with the same files are always up to date). This is perfect for game saves where we would want to play on 1 device, save our game, and then continue playing it on another device. This technology is what Epic/Steam/etc. use to allow you to do this on games run through their respective services. Syncthing is an open source implementation of this technology that you control, rather than relying on a 3rd party. This has a few key benefits, most notably - better security, privacy, and speed (when on your LAN).-------### What are some common issues?--Syncthing is fairly robust and doesn’t have many issues luckily, but there are some things you should watch out for (almost all of them a user issue).--- Sync conflicts- - If for whatever reason you update the same file on 2 different machines, the system does not know which updated file is considered the one to sync across. This results in a ***sync conflict*** where it may not sync the files as you would expect. Worst case scenario, this can result in your save progress being lost if you are not careful. When one of these occurs, it will create a copy of the file and store it with a specific name, like this example, *Paper Mario.sync-conflict-20251102-072925-TZBBN6S.srm.* To resolve this, you must remove the other files and remove the *.sync-conflict-<TIMESTAMP>-<Syncthing Device ID>* from the file name of the file you want to keep.-- Accidental Deletions- - If you delete a file from one of the devices, it will also remove the file on the other devices when they perform a sync so be careful when doing this.\ No newline at end of filediff --git a/docs/user/SyncthingGuide_Linux.md b/docs/user/SyncthingGuide_Linux.mddeleted file mode 100644index e7946151fc..0000000000--- a/docs/user/SyncthingGuide_Linux.md+++ /dev/null@@ -1,96 +0,0 @@-# Backing Up/Syncing Eden Game Saves--Use this guide for when you want to configure automated backup/syncing of your Eden save files using [*Syncthing*](https://syncthing.net/) on Linux.--**Click [Here](https://evilperson1337.notion.site/Backing-Up-Syncing-Eden-Game-Saves-2b057c2edaf680fc8a28eba5a05fd7a3) for a version of this guide with images & visual elements.**-------### Pre-Requisites--- Read the [*Syncthing General Guide*](./SyncthingGuide_General.md).-- Eden already installed, configured, and functioning.-------## Steps--<aside>--***WARNING***: You should manually back up your save files before proceeding with this guide. If you incorrectly perform the steps, you risk losing them!--</aside>--<aside>--***NOTE***: I am using Linux Mint for my guides, but the steps should translate pretty easily to your distro. I ***hope*** that if you are running Linux you know the basic operations. Steam Deck users should follow the guide specific to that platform.--</aside>--### Downloading and Installing Syncthing--1. Download [*Syncthing Tray*](https://flathub.org/en/apps/io.github.martchus.syncthingtray) from the Flatpak store.-2. Launch *Syncthing Tray* to run it, select the **Start guided setup** on the splash screen that appears and press **Next**.-3. It will then look for an existing *Syncthing* instance to pull settings from, but will likely fail to do so if you are here. Regardless, select the **Yes, continue configuration** option.-4. Select ***Start installed Syncthing application via Syncthing Tray***, this means it will use a built in Syncthing executable rather than relying on an externally provided one. Press **Next** to continue.-5. You will now be presented with a confirmation window with your selections, confirm they are what you want and hit **Apply** to continue.-6. You will now be prompted with a confirmation window that has a QR code and the devices identifier - you will need one of these to add other devices to the sync system.-7. *Syncthing/Syncthing Tray* are now installed. Press Finish to close the pop up.- <aside>-- ***NOTE***: By default due to flatpak sandboxing limitations, Syncthing Tray will not run automatically on login. You can get around this by following the [*instructions here*](https://github.com/flathub/io.github.martchus.syncthingtray).-- </aside>-------### Configuring this Machine as a Parent--Use this when you want to set this machine as the initial source of truth (push files out to all the other devices). Afterwards they will all be equal partners, not a parent/child relationship, this just helps with initial setup.--1. Right-Click the *Syncthing* Tray icon in your taskbar and select **Open Syncthing.**- 1. If you don’t have a taskbar in your distro, you can also reach it directly by opening a web browser to: *http://127.0.0.1:8384/.*-2. You will now have a browser window open up to a web GUI to configure *Syncthing*. You will get a pop up about allowing anonymous usage and setting a password, make your selections to close them.-3. We’ll start by adding the folder with our save files that we want to sync by Pressing **+ Add Folder**.-4. A pop-up window will appear, fill in the Folder label field with whatever you want to call it, like Switch Saves.-5. Enter the Full folder path to where your save files are stored on this machine.-- <aside>-- ***TIP***: The easiest way to do this would be to open Eden, right-click a game that has a save, hit ***Open Save Data Location,*** and then go up 1 directory. It should contain folders with the TitleID of your games.-- It should look similar to this: ..*\nand\user\save\0000000000000000\EC573727F509799675F6E5112C581D7E*-- </aside>--6. Ignore the other tabs for now and hit **Save**.-7. The folder is now ready to be shared with other devices.-------### Configuring this Machine as a Child--Use this when you want to set this machine up as a child (pull files from the other devices). Afterwards they will all be equal partners, not a parent/child relationship, this just helps with initial setup.--1. Install Syncthing Tray on the client device following the section above. Copy the child’s ID and store it so it is accessible to the Parent.-2. ***ON THE PARENT***: Right-Click the *Syncthing* Tray icon in your taskbar and select **Open Syncthing** if it is not open already**.**-3. You will now have a browser window open up to a web GUI to configure *Syncthing*. You will get a pop up about allowing anonymous usage and setting a password, make your selections to close them.-4. Navigate down to **+ Add Remote Device**, we are going to add our Child device, so I hope you have its ID handy. If not, go back and get it.-5. Add the ID and Name the device, the device may appear as a **nearby device**, in which case you can just click it to pre-populate the Device ID.-6. Click the **Sharing** Tab, and check the box next to the folder you set up on the Parent (Switch Saves in my case). Hit **Save.**-7. We are done with the parent, now **SWITCH OVER TO THE CHILD.**-8. ***ON THE CHILD***: Right-Click the *Syncthing* Tray icon in your taskbar and select **Open Syncthing** if it is not open already.-9. You should now see a connection request pop-up from the parent. Hit **+ Add Device** to add the device.-10. Hit **Save** to finish adding the device.-11. That pop-up will close and you will get notification that the device wants to share a folder now. Hit **Add.**-12. Enter the path to the save folder in Eden and hit **Save.**-- <aside>-- ***TIP***: The easiest way to do this would be to open Eden, right-click a game that has a save, hit ***Open Save Data Location,*** and then go up 1 directory. It should contain folders with the TitleID of your games.-- It should look similar to this: ..*\nand\user\save\0000000000000000\EC573727F509799675F6E5112C581D7E*-- </aside>--13. *Syncthing* will now pull all the files from the Parent and store them in your local save directory. At this point the files are in sync and alterations to one will affect the other and both can be considered “*Parents*” for other devices you want to add. Repeat these steps for as many devices you want.\ No newline at end of filediff --git a/docs/user/SyncthingGuide_Windows.md b/docs/user/SyncthingGuide_Windows.mddeleted file mode 100644index d94504423c..0000000000--- a/docs/user/SyncthingGuide_Windows.md+++ /dev/null@@ -1,95 +0,0 @@-# Backing Up/Syncing Eden Game Saves--Use this guide for when you want to configure automated backup/syncing of your Eden save files using [*Syncthing](https://syncthing.net/)* on Windows.--**Click [Here](https://evilperson1337.notion.site/Backing-Up-Syncing-Eden-Game-Saves-2b057c2edaf680f5aa9cd1c4f97121ce) for a version of this guide with images & visual elements.**-------### Pre-Requisites--- Read the [*Syncthing General Guide*](./SyncthingGuide_General.md).-- Eden already installed, configured, and functioning.-- Ability to allow a program to communicate through the firewall in Windows.-- Ability to extract archive (.zip/.7z/.rar) files.-------## Steps--<aside>--***WARNING***: You should manually back up your save files before proceeding with this guide. If you incorrectly perform the steps, you risk losing them!--</aside>--### Downloading and Installing *Syncthing*--1. Download [*Syncthing Tray*](https://martchus.github.io/syncthingtray/#downloads-section).- 1. While it is available as a command line interface, for most people I would recommend *Syncthing Tray* on Windows. For most people here, you would download the **64-bit (Intel/AMD)** version.-2. Open the downloaded archive and extract the **syncthingtray.exe** to wherever you want to store the executable.-3. Double-Click the application to run it, select the **Start guided setup** on the splash screen that appears and press **Next**.-- <aside>-- ***NOTE***: You may get a Windows Defender Smart Screen pop up, this is a known thing, just accept and run anyway.-- </aside>-4. It will then look for an existing Syncthing instance to pull settings from, but will likely fail to do so if you are here. Regardless, select the **Yes, continue configuration** option.-5. Select ***Start Syncthing application that is built into Syncthing Tray***, this means it will use a built in Syncthing executable rather than relying on an externally provided one. Press **Next** to continue.-6. Check the box to start Syncthing Tray on login - as the name implies, this means the program will run automatically whenever you log onto the computer. Press Next to continue.-7. You will now be presented with a confirmation window with your selections, confirm they are what you want and hit **Apply** to continue.-8. You will now be prompted with a confirmation window and a message to allow it through the firewall. Allow the access through the firewall to close that pop up. The confirmation screen has a QR code and the devices identifier - you will need one of these to add other devices to the sync system.-9. *Syncthing/Syncthing Tray* are now installed.-------### Configuring this Machine as a Parent--Use this when you want to set this machine as the initial source of truth (push files out to all the other devices). Afterwards they will all be equal partners, not a parent/child relationship, this just helps with initial setup.--1. Right-Click the *Syncthing* Tray icon in your taskbar and select **Open Syncthing.**-2. You will now have a browser window open up to a web GUI to configure *Syncthing*. You will get a pop up about allowing anonymous usage and setting a password, make your selections to close them.-3. We’ll start by adding the folder with our save files that we want to sync by Pressing **+ Add Folder**.-4. A pop-up window will appear, fill in the Folder label field with whatever you want to call it, like Switch Saves.-5. Enter the Full folder path to where your save files are stored on this machine.-- <aside>-- ***TIP***: The easiest way to do this would be to open Eden, right-click a game that has a save, hit ***Open Save Data Location,*** and then go up 1 directory. It should contain folders with the TitleID of your games.-- It should look similar to this: ..*\nand\user\save\0000000000000000\EC573727F509799675F6E5112C581D7E*-- </aside>--6. Ignore the other tabs for now and hit **Save**.-7. The folder is now ready to be shared with other devices.-------### Configuring this Machine as a Child--Use this when you want to set this machine up as a child (pull files from the other devices). Afterwards they will all be equal partners, not a parent/child relationship, this just helps with initial setup.--1. Install Syncthing Tray on the client device following the section above. Copy the child’s ID and store it so it is accessible to the Parent.-2. ***ON THE PARENT***: Right-Click the *Syncthing* Tray icon in your taskbar and select **Open Syncthing** if it is not open already**.**-3. You will now have a browser window open up to a web GUI to configure *Syncthing*. You will get a pop up about allowing anonymous usage and setting a password, make your selections to close them.-4. Navigate down to **+ Add Remote Device**, we are going to add our Child device, so I hope you have its ID handy. If not, go back and get it.-5. Add the ID and Name the device, the device may appear as a **nearby device**, in which case you can just click it to pre-populate the Device ID.-6. Click the **Sharing** Tab, and check the box next to the folder you set up on the Parent (Switch Saves in my case). Hit **Save.**-7. We are done with the parent, now **SWITCH OVER TO THE CHILD.**-8. ***ON THE CHILD***: Right-Click the *Syncthing* Tray icon in your taskbar and select **Open Syncthing** if it is not open already**.**-9. You should now see a connection request from the parent. Hit **+ Add Device** to add the device.-10. Hit **Save** to finish adding the device.-11. That pop-up will close and you will get notification that the device wants to share a folder now. Hit **Add.**-12. Enter the path to the save folder in Eden and hit **Save.**-- <aside>-- ***TIP***: The easiest way to do this would be to open Eden, right-click a game that has a save, hit ***Open Save Data Location,*** and then go up 1 directory. It should contain folders with the TitleID of your games.-- It should look similar to this: ..*\nand\user\save\0000000000000000\EC573727F509799675F6E5112C581D7E*-- </aside>--13. *Syncthing* will now pull all the files from the Parent and store them in your local save directory. At this point the files are in sync and alterations to one will affect the other and both can be considered “*Parents*” for other devices you want to add. Repeat these steps for as many devices you want.\ No newline at end of filediff --git a/docs/user/Testing.md b/docs/user/Testing.mdindex 4ef7925f90..6c3b7d3e15 100644--- a/docs/user/Testing.md+++ b/docs/user/Testing.md@@ -2,6 +2,11 @@While this is mainly aimed for testers - normal users can benefit from these guidelines to make their life easier when trying to outline and/or report an issue.+## Getting logs++In order to get more information, you can find logs in the following location:++## How to Test a PR Against the Based Master When Issues AriseWhen you're testing a pull request (PR) and encounter unexpected behavior, it's important to determine whether the issue was introduced by the PR or if it already exists in the base code. To do this, compare the behavior against the based master branch.diff --git a/docs/user/ThirdParty.md b/docs/user/ThirdParty.mdindex 4c337b2c5f..af8942b49c 100644--- a/docs/user/ThirdParty.md+++ b/docs/user/ThirdParty.md@@ -6,3 +6,4 @@ While most of the links mentioned in this guide are relatively "safe"; we urge u- [Nightly Eden builds](https://github.com/pflyly/eden-nightly)- [NixOS Eden Flake](https://github.com/Grantimatter/eden-flake)+- [ES-DE Frontend Support](https://github.com/GlazedBelmont/es-de-android-custom-systems)diff --git a/docs/user/EdenFailsToLaunch_Windows.md b/docs/user/Troubleshoot.mdsimilarity index 84%rename from docs/user/EdenFailsToLaunch_Windows.mdrename to docs/user/Troubleshoot.mdindex 9a30348092..0aebfc5b96 100644--- a/docs/user/EdenFailsToLaunch_Windows.md+++ b/docs/user/Troubleshoot.md@@ -1,10 +1,22 @@-# Eden Fails to Launch and Does Not Leave Any Logs+# User Handbook - Troubleshooting-**Click [Here](https://evilperson1337.notion.site/Windows-Eden-Fails-to-Launch-and-Does-Not-Leave-Any-Logs-2b057c2edaf68156b640cf1ac549870a) for a version of this guide with images & visual elements.**+## Vulkan initialization error----+- Ensure you have the latest drivers+- Uninstall old drivers, for Windows you can use [Display Driver Uninstaller](https://www.guru3d.com/download/display-driver-uninstaller-download/)+- Change backend manually in the settings file (set it from `0` to `1` or viceversa).+- Disconnect your second monitor, if any++## This mod only works on an Emulator++- Enable RNG seed+- Set RNG seed to 0++## Eden Fails to Launch and Does Not Leave Any Logs++**Click [Here](https://evilperson1337.notion.site/Windows-Eden-Fails-to-Launch-and-Does-Not-Leave-Any-Logs-2b057c2edaf68156b640cf1ac549870a) for a version of this guide with images & visual elements.**-## Error Details+### Error Details*Behavior*: Program appears not to launch or exits immediately without leaving any log entries.*Platform(s) Affected*:@@ -32,13 +44,11 @@ Faulting package-relative application ID:----## Causes+### Causes<aside>-### Issue 1: Missing C++ Redistributable-----+#### Issue 1: Missing C++ Redistributable*Eden requires the latest C++ redistributable from Microsoft in order to run. Like many other programs, it relies on aspects and libraries included in this runtime, without it - the program cannot run.*@@ -50,9 +60,7 @@ Faulting package-relative application ID:<aside>-### Issue 2: Corrupted System Files-----+#### Issue 2: Corrupted System Files*A corruption of necessary system files can cause odd behaviors when Eden tries to access them. It is a very rare case and you would likely see other programs misbehaving if this is what your issue is, but you can try if you have no other options.*@@ -88,4 +96,4 @@ Faulting package-relative application ID:8. Reboot your computer.9. Launch Eden and verify it is now working.-</aside>\ No newline at end of file+</aside>diff --git a/docs/user/UsingAmiibo_Windows.md b/docs/user/UsingAmiibo.mdsimilarity index 93%rename from docs/user/UsingAmiibo_Windows.mdrename to docs/user/UsingAmiibo.mdindex e7cbae7cf0..4288517bec 100644--- a/docs/user/UsingAmiibo_Windows.md+++ b/docs/user/UsingAmiibo.md@@ -1,10 +1,14 @@-# Using Amiibo with Eden+# User Handbook - Using AmiiboUse this guide when you want to load Amiibo into your games for use with the Eden emulator.**Click [Here](https://evilperson1337.notion.site/Using-Amiibo-with-Eden-2b057c2edaf681b1b28ec6be600c6d3e) for a version of this guide with images & visual elements.**----+## Android++TBD++## Desktop### Pre-Requisites@@ -17,9 +21,7 @@ Use this guide when you want to load Amiibo into your games for use with the Ede</aside>-## Steps-----+### Steps1. Launch Eden and launch the game you want to load Amiibo for.<aside>@@ -40,4 +42,4 @@ Use this guide when you want to load Amiibo into your games for use with the Ede</aside>5. Upon loading a valid file, you will get a confirmation screen and your bonus content will be unlocked/functionality activated.-6. Repeat with any other Amiibo you want to use.\ No newline at end of file+6. Repeat with any other Amiibo you want to use.diff --git a/docs/user/UsingCheats_Android.md b/docs/user/UsingCheats.mdsimilarity index 50%rename from docs/user/UsingCheats_Android.mdrename to docs/user/UsingCheats.mdindex cd7538be9d..f0da068582 100644--- a/docs/user/UsingCheats_Android.md+++ b/docs/user/UsingCheats.md@@ -1,10 +1,10 @@-# Using Cheats with Eden+# User Handbook - Using CheatsUse this guide when you want to add cheats into a game to alter gameplay for use with the Eden emulator.**Click [Here](https://evilperson1337.notion.site/Using-Cheats-with-Eden-2b057c2edaf6818fab66c276e2304bb4) for a version of this guide with images & visual elements.**----+## Android### Pre-Requisites@@ -21,11 +21,7 @@ Another option would be to launch the game in Eden and close it - then go into t</aside>------## Steps--### Configuring a Cheat+### Step 1: Configuring a Cheat1. Create a directory somewhere accessible on your phone with the name of the cheat. The name you choose only affects how it is displayed in Eden.2. Create a directory inside of this folder called **cheats.**@@ -52,9 +48,7 @@ Another option would be to launch the game in Eden and close it - then go into t2. You should now see the cheat appear in the **Add-ons** screen.3. Launch the game and confirm that the cheat is applied.------### Multiple Cheats+### Step 2: Multiple CheatsIn order to install multiple cheats, you must repeat the steps above with the new cheat, creating a new directory with the name of the cheat and cheats directory. You **cannot** install multiple cheats with a single file.@@ -79,9 +73,7 @@ Community Member [Ninjistix](https://github.com/Ninjistix) created a utility (Wi040E0000 0048A818 52800028```------### Enabling/Disabling Cheats+### Step 3: Enabling/Disabling CheatsCheats are enabled by default, but can be disabled so they don’t affect gameplay fairly easily using the game properties.@@ -89,4 +81,76 @@ Cheats are enabled by default, but can be disabled so they don’t affect gamepl2. Scroll down on the properties until you see **Add-ons**, select this option.3. *Select/Deselect* the name of the cheat you wish to enable/disable.4. Click **OK** to close the window.-5. Launch the game to confirm the cheat is/is not active.\ No newline at end of file+5. Launch the game to confirm the cheat is/is not active.++## Desktop++### Pre-Requisites++- Eden Emulator fully set up and configured+- The cheat(s) you want to apply+- The **Build ID** of the game.++<aside>++***TIP***: The easiest way I have found to find the Build ID is by Right-Clicking the game **IN RYUJINX** and hitting **Manage Cheats**. Your Build ID will be displayed at the top.++Another option would be to launch the game in Eden and close it - then go into the log and look for a line like this - the first 16 characters if your Build ID. **Make sure that it is the MAIN line**.+`[ 27.098382] Loader <Info> core/file_sys/patch_manager.cpp:HasNSOPatch:304: Querying NSO patch existence for build_id=AEE6DCCC06D9C05B42061E2019123A61, name=main`++</aside>++### Step 1: Configuring a Cheat++1. Copy the Hex Code of the cheat into a text file, optionally with the cheat name at the beginning like the example. Here this code will set the timer to 999 in *New Super Mario Bros. U Deluxe.*++ ```bash+ [Time = 999]+ 58000000 00C88A70+ 78001000 00000090+ 64000000 00000000 003E6F00+ ```++1. Save the file as a **txt** file with the Build ID of the game. For my example, my Build ID is **AEE6DCCC06D9C05B** so my file would be `AEE6DCCC06D9C05B.txt`.+2. Launch Eden and wait for the program to load.+3. *Right-Click* the game in Eden and select **Open Mod Data Location**. A file explorer window should appear.+4. Create a folder inside of the file explorer window with the name of the cheat. This name does not matter and only affects how it appears in the game properties inside of Eden.+5. Navigate inside of this folder and create another folder called **cheats.**+6. Move the txt file you created earlier into this **cheats** folder. (e.g. `<mod_location>/Time 999/cheats/AEE6DCCC06D9C05B.txt` )+7. Go back to Eden and *right-click* the game. Select *Configure Game* and you should now see the cheat you created appear in the **Add-Ons** section with the name of the folder from step 6.+8. Launch the game to verify that the cheat is enabled.++### Step 2: Multiple Cheats++In order to install multiple cheats, you must repeat the steps above with the new cheat, creating a new directory with the name of the cheat and cheats directory. You **cannot** install multiple cheats with a single file.++Community Member [Ninjistix](https://github.com/Ninjistix) created a utility (Windows or anything that can run Python) that can take a file with multiple cheats and create the files/structure for you with a provided Build ID. To download and run it, see the [GitHub Project](https://github.com/Ninjistix/nxCheat_Splitter) page.++**Example cheat TXT file with multiple cheats. It must be in this format to work:**+```+[Super Mario Bros. Wonder - Various] <- Optional++[♯ 1. Always Star Power]+040E0000 00880580 52800035++[♯ 2. Star Power + Bubble Mode (Invincible)]+040E0000 00880580 52800075++[♯ 3. Can Fast Travel to Any Course and World]+040E0000 00935E10 52800036+040E0000 0048A528 52800028+040E0000 005D9F58 52800028++[♯ 4. Got All Top of Flag Poles]+040E0000 0048A818 52800028+```++### Step 3: Enabling/Disabling Cheats++Cheats are enabled by default, but can be disabled so they don’t affect gameplay fairly easily using the game properties.++1. *Right-Click* the game and select *Configure Game*.+2. In the **Add-Ons** section, locate the cheat you wish to enable.+3. *Select/Deselect* the name of the cheat you wish to enable/disable.+4. Click **OK** to close the window.+5. Launch the game to confirm the cheat is/is not active.diff --git a/docs/user/UsingCheats_Windows.md b/docs/user/UsingCheats_Windows.mddeleted file mode 100644index c2a23f869c..0000000000--- a/docs/user/UsingCheats_Windows.md+++ /dev/null@@ -1,83 +0,0 @@-# Using Cheats with Eden--Use this guide when you want to add cheats into a game to alter gameplay for use with the Eden emulator.--**Click [Here](https://evilperson1337.notion.site/Using-Cheats-with-Eden-2b057c2edaf6818fab66c276e2304bb4) for a version of this guide with images & visual elements.**-------### Pre-Requisites--- Eden Emulator fully set up and configured-- The cheat(s) you want to apply-- The **Build ID** of the game.--<aside>--***TIP***: The easiest way I have found to find the Build ID is by Right-Clicking the game **IN RYUJINX** and hitting **Manage Cheats**. Your Build ID will be displayed at the top.--Another option would be to launch the game in Eden and close it - then go into the log and look for a line like this - the first 16 characters if your Build ID. **Make sure that it is the MAIN line**.-`[ 27.098382] Loader <Info> core/file_sys/patch_manager.cpp:HasNSOPatch:304: Querying NSO patch existence for build_id=AEE6DCCC06D9C05B42061E2019123A61, name=main`--</aside>--## Steps-------### Configuring a Cheat--1. Copy the Hex Code of the cheat into a text file, optionally with the cheat name at the beginning like the example. Here this code will set the timer to 999 in *New Super Mario Bros. U Deluxe.*-- ```bash- [Time = 999]- 58000000 00C88A70- 78001000 00000090- 64000000 00000000 003E6F00- ```--1. Save the file as a **txt** file with the Build ID of the game. For my example, my Build ID is **AEE6DCCC06D9C05B** so my file would be `AEE6DCCC06D9C05B.txt`.-2. Launch Eden and wait for the program to load.-3. *Right-Click* the game in Eden and select **Open Mod Data Location**. A file explorer window should appear.-4. Create a folder inside of the file explorer window with the name of the cheat. This name does not matter and only affects how it appears in the game properties inside of Eden.-5. Navigate inside of this folder and create another folder called **cheats.**-6. Move the txt file you created earlier into this **cheats** folder. (e.g. `<mod_location>/Time 999/cheats/AEE6DCCC06D9C05B.txt` )-7. Go back to Eden and *right-click* the game. Select *Configure Game* and you should now see the cheat you created appear in the **Add-Ons** section with the name of the folder from step 6.-8. Launch the game to verify that the cheat is enabled.--### Multiple Cheats--In order to install multiple cheats, you must repeat the steps above with the new cheat, creating a new directory with the name of the cheat and cheats directory. You **cannot** install multiple cheats with a single file.--Community Member [Ninjistix](https://github.com/Ninjistix) created a utility (Windows or anything that can run Python) that can take a file with multiple cheats and create the files/structure for you with a provided Build ID. To download and run it, see the [GitHub Project](https://github.com/Ninjistix/nxCheat_Splitter) page.--**Example cheat TXT file with multiple cheats. It must be in this format to work:**-```-[Super Mario Bros. Wonder - Various] <- Optional--[♯ 1. Always Star Power]-040E0000 00880580 52800035--[♯ 2. Star Power + Bubble Mode (Invincible)]-040E0000 00880580 52800075--[♯ 3. Can Fast Travel to Any Course and World]-040E0000 00935E10 52800036-040E0000 0048A528 52800028-040E0000 005D9F58 52800028--[♯ 4. Got All Top of Flag Poles]-040E0000 0048A818 52800028-```-------### Enabling/Disabling Cheats--Cheats are enabled by default, but can be disabled so they don’t affect gameplay fairly easily using the game properties.--1. *Right-Click* the game and select *Configure Game*.-2. In the **Add-Ons** section, locate the cheat you wish to enable.-3. *Select/Deselect* the name of the cheat you wish to enable/disable.-4. Click **OK** to close the window.-5. Launch the game to confirm the cheat is/is not active.\ No newline at end of file