OpenPunk/citra
1
0
Fork 0
mirror of https://github.com/citra-emu/citra.git synced 2024-11-22 17:50:05 +00:00
Code Issues Projects Releases Wiki Activity

Fixed some typos, formattings and major information changes on API ERROR 1282 OPENGL error

Dragios 2016-09-12 14:33:54 +08:00
parent 728d0f2d81
commit 9914608d4e
1 changed files with 54 additions and 59 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

111
FAQ.md

@ -1,93 +1,93 @@
## About Citra ## About Citra
#### What is Citra? #### What is _Citra_?
Citra is a work-in-progress Nintendo 3DS emulator started in early 2014. Citra can currently emulate, with varying degrees of success, a wide variety of different homebrew programs and commercial software. _Citra_ is a work-in-progress _Nintendo 3DS_ emulator started in early 2014. _Citra_ can currently emulate, with varying degrees of success, a wide variety of different homebrew programs and commercial software.
#### What is Citra's License? #### What is _Citra_'s License?
Citra is an open-source project, licensed under the GPLv2 (or any later version). Refer to the [license document](https://github.com/citra-emu/citra/blob/master/license.txt) for more information. _Citra_ is an open-source project, licensed under the GPLv2 (or any later version). Refer to the [license document](https://github.com/citra-emu/citra/blob/master/license.txt) for more information.
#### Who made Citra? #### Who made _Citra_?
Citra has an active team of open-source developers. Over 50 people have worked hard on the project since its founding in 2014! The list of contributors can be found on [GitHub](https://github.com/citra-emu/citra/graphs/contributors). _Citra_ has an active team of open-source developers. Over 50 people have worked hard on the project since its founding in 2014! The list of contributors can be found on [GitHub](https://github.com/citra-emu/citra/graphs/contributors).
Citra is not affiliated with Nintendo in any way. _Note: Citra is not affiliated with Nintendo in any way._
## Running games in Citra ## Running games in _Citra_
#### Can Citra run Pokémon games? #### Can _Citra_ run _Pokémon_ games?
Yes, but they require a [[Home Folder dump|Home Folder]], and crashes are common. Yes, but they require a [[Home Folder dump|Home Folder]] and crashes are common.
#### Where can I download games to use with Citra? #### Where can I download games to use with _Citra_?
Short answer: You don't. Buy games and dump them with a Nintendo 3DS. Short answer: You don't. Buy games and dump them with a _Nintendo 3DS_.
Long answer: Downloading commercial games is illegal and thus strongly frowned upon by the Citra developers. To prevent legal issues, this includes gray areas like downloading games which you purchased earlier. You don't necessarily need to own a 3DS yourself, as you can buy game cartridges and dump them with a friend's console. On the other hand, copying a friend's game dump is considered illegal. Please note that any mention or discussion of piracy on our forum or IRC channels will result in being banned from our community. Long answer: Downloading commercial games is illegal and thus strongly frowned upon by the _Citra_ developers. To prevent legal issues, this includes gray areas like downloading games which you purchased earlier. You don't necessarily need to own a 3DS yourself, as you can buy game cartridges and dump them with a friend's console. On the other hand, copying a friend's game dump is considered illegal. Please note that any mention or discussion of piracy on our forum or IRC channels will result in being banned from our community.
Please refer to [[Dumping Game Cartridges]] for guidance on how to dump games for use with Citra. Please refer to [[Dumping Game Cartridges]] for guidance on how to dump games for use with Citra.
#### When launching a game, I get a "Failed to Decrypt Error". I want to run backups of retail titles that I own, how can I do that? #### When launching a game, I get a "Failed to Decrypt Error". I want to run backups of retail titles that I own, how can I do that?
Citra does not natively run dumps of games that have not been decrypted properly. This requires a physical 3DS and the game be owned. _Citra_ does not natively run dumps of games that have not been decrypted properly. This requires a physical 3DS and the game you owned.
Refer to [[Dumping Game Cartridges]]. Refer to [[Dumping Game Cartridges]].
#### Does this mean I can play \<insert retail game here\> on my PC? #### Does this mean I can play \<Insert retail game name here\> on my PC?
Citra can, ostensibly, "play" many different games, including The Legend of Zelda: Ocarina of Time and Animal Crossing. _Citra_ can, ostensibly, "play" many different games, including The _Legend of Zelda: Ocarina of Time_ and _Animal Crossing_.
Many games, however, will not load at all—only showing a black screen. Many other games will only show the title screen and then freeze or crash. Many games, however, will not load at all—only showing a black screen. Many other games will only show the title screen and then freeze or crash.
You can expect many games to run slowly, though, and to exhibit many gameplay and graphical glitches. You can expect many games to run slowly, though, and to exhibit many gameplay and graphical glitches.
If you're interested in 3DS emulation as an experiment, you may gain something out of trying Citra, but if you're simply looking to play games then stick to your 3DS handheld. If you're interested in 3DS emulation as an experiment, you may gain something out of trying _Citra_, but if you're simply looking to play games then stick to your 3DS handheld.
#### Can I expect Citra to play [GAME] at full-speed? #### Can I expect _Citra_ to play [GAME] at full-speed?
Citra cannot currently play most games at full speed, especially games that have 3D graphics. _Citra_ cannot currently play most games at full speed, especially games that have 3D graphics.
#### I saw a YouTube video about [GAME], why doesn't it work on the nightly build? #### I saw a _YouTube_ video about [GAME], why doesn't it work on the nightly build?
Alternative custom branches may have not been merged into master. We only support nightly builds based on the [master branch](https://github.com/citra-emu/citra). Alternative custom branches may have not been merged into master. We only support nightly builds based on the [master branch](https://github.com/citra-emu/citra).
Unofficial branches are not supported. There may be other branches that are planned to be merged, but must go through vetting first to ensure they are good contributions to the project long term. Unofficial builds are not supported. There may be other branches that are planned to be merged, but must go through vetting first to ensure they are good contributions to the project long term.
## System requirements and common issues ## System requirements and common issues
#### Which platforms does Citra support? #### Which platforms does _Citra_ support?
We're pleased to say that Citra works on all three major desktop OSes! We're pleased to say that _Citra_ works on all three major desktop OSes!
Citra is actively tested and supported on 64-bit versions of Windows (7 and up), Linux and OS X. Other platforms may work, but aren't tested by developers. In the far future, mobile platforms may be targeted as well. _Citra_ is actively tested and supported on various 64-bit version of _Windows_ (_7_ and up), _Linux_ and _Mac OS X_. Other platforms may work, but aren't tested by developers. In far future, mobile platforms may be targeted as well.
We have no plans to support 32-bit operating systems officially. We have no plans to support 32-bit operating system officially.
#### What kind of specs do I need to run Citra? #### What kind of specification do I need to run _Citra_?
At this point, Citra is simply not fast enough to run most commercial games at full speed, even if your computer can run the most demanding of PC games just fine. At this point, _Citra_ is simply not fast enough to run most commercial games at full speed, even if your computer can run the most demanding of PC games just fine.
The only _hard_ requirements for the official version of Citra is a graphics chip that supports **at least OpenGL 3.3** and a **64-bit OS**, but you definitely want a processor with the highest possible performance per core. The only **hard** requirements for the official version of _Citra_ is a graphics chip that supports **at least _OpenGL 3.3_** and a **64-bit OS**, but you definitely want a processor with the highest possible performance per core.
Note that you can also use a software implementation of OpenGL like Mesa. Only do this if your hardware does not support OpenGL 3.3, even with latest updates \- It will be much slower than a real GPU. Note that you can also use a software implementation of _OpenGL_ like _Mesa_. Only do this if your hardware does not support _OpenGL 3.3_, even with latest updates \- It will be much slower than a real GPU.
For Linux Mesa users it should be enough to define the environment variable `LIBGL_ALWAYS_SOFTWARE=1` temporarily. Windows users can copy the opengl32.dll from [this package](https://sourceforge.net/projects/msys2/files/REPOS/MINGW/x86_64/mingw-w64-x86_64-mesa-11.2.0-1-any.pkg.tar.xz/download) to their Citra folder. For Linux Mesa users it should be enough to define the environment variable `LIBGL_ALWAYS_SOFTWARE=1` temporarily. _Windows_ users can copy the `opengl32.dll` from [this package](https://sourceforge.net/projects/msys2/files/REPOS/MINGW/x86_64/mingw-w64-x86_64-mesa-11.2.0-1-any.pkg.tar.xz/download) to their _Citra_ folder.
#### When I try to start any game, Citra immediately crashes! #### When I try to start any game, _Citra_ immediately crashes!
It is very likely that this issue is caused by your GPU or drivers not supporting OpenGL 3.3. Try updating to the latest drivers if possible, and verify that either your driver control panel or a tool like [GPU Caps Viewer](http://www.ozone3d.net/gpu_caps_viewer/) reports that you can use at least OpenGL 3.3. If updating drivers doesn't help, you'll need to upgrade your GPU or wait until we remove this limitation from the software renderer. (The hardware renderer will never support lower OpenGL versions.) It is very likely that this issue is caused by your GPU or drivers not supporting _OpenGL 3.3_. Try updating to the latest drivers if possible, and verify that either your driver's control panel or a tool like [GPU Caps Viewer](http://www.ozone3d.net/gpu_caps_viewer/) reports that you can use at least _OpenGL 3.3_. If updating drivers doesn't help, you'll need to upgrade your GPU or wait until we remove this limitation from the software renderer. (The hardware renderer will never support lower _OpenGL_ versions.)
*Also read the previous question / answer for a software implementation of OpenGL* *Also read the previous question / answer for a software implementation of _OpenGL_*
#### Citra complains about missing DLLs. #### _Citra_ complains about missing DLLs.
First, if you've downloaded any DLL files from the Internet and placed them in the Citra or a system folder, *remove them first*, they will not solve your problem and may cause system instability. Then download and install the *x64* variant (vc_redist.x64.exe) of [Visual C++ Redistributable for Visual Studio 2015](https://www.microsoft.com/en-us/download/details.aspx?id=48145) from Microsoft. If that doesn't help, ensure you have also extracted the DLL files that come included with the Citra builds and that they are in the same directory as the executable. First, if you've downloaded any DLL files from the Internet and placed them in the _Citra_ or a system folder, *remove them first*, they will not solve your problem and may cause system instability. Then download and install the *x64* variant (vc_redist.x64.exe) of [Visual C++ Redistributable for Visual Studio 2015](https://www.microsoft.com/en-us/download/details.aspx?id=48145) from _Microsoft_. If that doesn't help, ensure you have also extracted the DLL files that come included with the _Citra_ builds and that they are in the same directory as the executable.
#### A message box pops up saying the application was was unable to start correctly (0xc000007b). #### A message box pops up saying the application was was unable to start correctly `0xc000007b`.
See above about missing DLLs. See above about missing DLLs.
#### I've dumped my game, but when I load it Citra crashes/prints a bunch of gibberish to the console! #### I've dumped my game but when I load it, _Citra_ crashes/prints a bunch of gibberish to the console!
Games need to be decrypted on a 3DS before being usable in Citra. This is a technical limitation and it is unlikely that it can be removed in the foreseeable future. To decrypt your games, you will need to have a 3DS system running firmware 9.2 or lower and follow the [[Dumping Game Cartridges]] guide. Games need to be decrypted on a 3DS before being usable in _Citra_. This is a technical limitation and it is unlikely that it can be removed in the foreseeable future. To decrypt your games, you will need to have a 3DS system running firmware 9.2 or lower and follow the [[Dumping Game Cartridges]] guide.
#### What should I do if I get an error saying something like "GetConfigInfoBlock: Config block 0xXXXXX with flags X and size X was not found"? #### What should I do if I get an error saying something like "`GetConfigInfoBlock: Config block 0xXXXXX with flags X and size X was not found`"?
Sometimes a game will freeze and you'll get an error which looks like this in the log, usually followed by a "Fatal Error": Sometimes a game will freeze and you'll get an error which looks like this in the log, usually followed by a "Fatal Error":
@ -97,39 +97,33 @@ Service.CFG <Error> core\hle\service\cfg\cfg.cpp:Service::CFG::GetConfigInfoBloc
In this case, try deleting the file at `user/nand/data/00000000000000000000000000000000/sysdata/00010017/00000000/config` and running the latest version of Citra. If this does not work, then note the config block number (`0xA0001` in the example) and file a bug report. In this case, try deleting the file at `user/nand/data/00000000000000000000000000000000/sysdata/00010017/00000000/config` and running the latest version of Citra. If this does not work, then note the config block number (`0xA0001` in the example) and file a bug report.
#### How can I fix the "API ERROR 1282 OPENGL" ? I can't figure that out by changing ROM and Version ! #### How can I fix the `API ERROR 1282 OPENGL` error? I can't figure out what is causing this to happen!
This is all about third-part applications : there are some GPU/CPU utilities that use to monitor the GPU/CPU usage to control fan speeds(or something like). This is the result of third-party application that uses overlays which might conflict with _Citra_
Citra could have some problems related to these applications,the API Error 1282 is one of these cases,you could keep on getting this console error (no matter which ROM you're running on which version) : The console will print this error log :
``` ```
Render.OpenGL <Error> video_core\renderer_opengl\renderer_opengl.cpp:DebugHandler:469: API ERROR 1282: GL_INVALID_OPERATION error generated. Function glMatrixMode is deprecated and not available in preview contexts. Render.OpenGL <Error> video_core\renderer_opengl\renderer_opengl.cpp:DebugHandler:469: API ERROR 1282: GL_INVALID_OPERATION error generated. Function glMatrixMode is deprecated and not available in preview contexts.
Render.OpenGL <Error> video_core\renderer_opengl\renderer_opengl.cpp:DebugHandler:469: API ERROR 1282: GL_INVALID_OPERATION error generated. Function glPushMatrix is deprecated and not available in preview contexts.
Render.OpenGL <Error> video_core\renderer_opengl\renderer_opengl.cpp:DebugHandler:469: API ERROR 1282: GL_INVALID_OPERATION error generated. Function glLoadIdentity is deprecated and not available in preview contexts.
Render.OpenGL <Error> video_core\renderer_opengl\renderer_opengl.cpp:DebugHandler:469: API ERROR 1282: GL_INVALID_OPERATION error generated. Function glOrtho is deprecated and not available in preview contexts.
``` ```
So far only _MSI Afterburner_ is being reported to have conflicts with _Citra_, therefore it is advisable to close it before launching _Citra_.
It could be also "Vertex Core" or something like. Well,just kill those processes related to Gpu/CPU Utilities,be careful,there are lots of utilies working smoothly with Citra,like :
- Zotac FireStorm
- Speccy
- Steam
- Origin
- geForce Experience
MSI Afterburner was ,in some cases,the application responsable of the error,some users could figure that out by closing it.
#### Where is the folder for the emulated SD card? #### Where is the folder for the emulated SD card?
The folder for the emulated SD card is named `sdmc`. The folder for the emulated SD card is named `sdmc`.
Under Windows, you can find it in the `user` folder along with the citra executable. Under _Windows_, you can find it in the `user` folder along with the _Citra_ executable.
Under Linux, you can find it in `~/.local/share/citra-emu/`. Under _Linux_, you can find it in `~/.local/share/citra-emu/`.
## Development and contributions ## Development and contributions
#### How can I develop or contribute to the project? #### How can I develop or contribute to the project?
If you're interested in contributing, fork the project here in GitHub, and then create a Pull Request when you're ready to submit your contribution. Unless your change is trivial, however, it is strongly recommended that you join our development channel (#citra-dev @ [Freenode](https://webchat.freenode.net/)) to coordinate with the developers beforehand. Make sure to review our [coding guidelines](https://github.com/citra-emu/citra/blob/master/CONTRIBUTING.md) and ensure your changes follow them. If you're looking for ideas on things to work on, try looking around our issue tracker. Some issues are tagged with the [D-easy](https://github.com/citra-emu/citra/issues?q=is:open+is:issue+label:D-easy) label, which means they're smaller tasks that should be easier to get into. If you're interested in contributing, fork the project here in [_GitHub_](https://github.com/citra-emu/citra), and then create a Pull Request when you're ready to submit your contribution. Unless your change is trivial, however, it is strongly recommended that you join our development channel (#citra-dev @ [Freenode](https://webchat.freenode.net/)) to coordinate with the developers beforehand. Make sure to review our [coding guidelines](https://github.com/citra-emu/citra/blob/master/CONTRIBUTING.md) and ensure your changes follow them. If you're looking for ideas on things to work on, try looking around our issue tracker. Some issues are tagged with the [D-easy](https://github.com/citra-emu/citra/issues?q=is:open+is:issue+label:D-easy) label, which means they're smaller tasks that should be easier to get into.
#### I'd like to be a beta tester, how can I help? #### I'd like to be a beta tester, how can I help?
@ -137,14 +131,15 @@ If you try some games and run into issues like graphical glitches, freezes and e
#### Non-official builds are faster, have more features and run more games. Why don't you work with the people who create those? #### Non-official builds are faster, have more features and run more games. Why don't you work with the people who create those?
Most non-official builds are just a collection of different features currently being worked on by Citra contributors from the community. Most non-official builds are just a collection of different features currently being worked on by _Citra_ contributors from the community.
These features are not part of the official version (yet) because they are either broken-by-design and would possibly hinder development soon or because they are still work in progress. These features are not part of the official version (yet) because they are either broken-by-design and would possibly hinder development soon or because they are still work in progress.
Also, each change will go through a review process. Features found in non-official versions are often in the review phase already and will be included in official versions about a month or two later. Also, each change will go through a review process. Features found in non-official versions are often in the review phase already and will be included in official versions about a month or two later.
If you are the author of a non-official build make sure you still follow the license of Citra. If you are the author of a non-official build make sure you still follow the license of _Citra_.
#### I think what you guys are doing is awesome! I am not a developer, but still want to support the project. What can I do? #### I think what you guys are doing is awesome! I am not a developer, but still want to support the project. What can I do?
That's awesome! Such support is what motivates us to keep working! Stick around and keep motivating our work! That's awesome! Such support is what motivates us to keep working! Stick around and keep motivating our work!
If you're interested in donating, we would gladly accept used hardware, games for testing, or money for development/infrastructure costs. Please see our [donations page](https://citra-emu.org/page/donate) for more information, or join our IRC channel (#citra @ [Freenode](https://webchat.freenode.net/)) and contact a developer. If you're interested in donating, we would gladly accept used hardware, games for testing, or money for development/infrastructure costs. Please see our [donations page](https://citra-emu.org/page/donate) for more information, or join our IRC channel (#citra @ [Freenode](https://webchat.freenode.net/)) and contact a developer.
***