{"id":13590318,"url":"https://github.com/coin3d/coin","last_synced_at":"2025-04-14T23:28:33.022Z","repository":{"id":38395860,"uuid":"229825611","full_name":"coin3d/coin","owner":"coin3d","description":"Coin3D core library","archived":false,"fork":false,"pushed_at":"2025-04-01T19:23:59.000Z","size":133446,"stargazers_count":310,"open_issues_count":56,"forks_count":114,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-04-07T16:13:40.048Z","etag":null,"topics":["3d-graphics","open-inventor","opengl","rendering","scenegraph"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/coin3d.png","metadata":{"files":{"readme":"README.MACOSX","changelog":"ChangeLog","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-12-23T21:31:02.000Z","updated_at":"2025-04-01T19:23:22.000Z","dependencies_parsed_at":"2022-08-25T05:11:59.384Z","dependency_job_id":"80ace35e-c5c0-40ab-954f-f69f469323a7","html_url":"https://github.com/coin3d/coin","commit_stats":{"total_commits":12083,"total_committers":81,"mean_commits":"149.17283950617283","dds":0.6407349168252917,"last_synced_commit":"2e7e4d041a9bce29ac288ab1aa40d4ed5a00bac7"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coin3d%2Fcoin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coin3d%2Fcoin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coin3d%2Fcoin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coin3d%2Fcoin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coin3d","download_url":"https://codeload.github.com/coin3d/coin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248977218,"owners_count":21192543,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d-graphics","open-inventor","opengl","rendering","scenegraph"],"created_at":"2024-08-01T16:00:43.509Z","updated_at":"2025-04-14T23:28:32.979Z","avatar_url":"https://github.com/coin3d.png","language":"C++","funding_links":[],"categories":["C++"],"sub_categories":[],"readme":"For building Coin on macOS platform, you should in general follow the\ninstructions in the INSTALL file.\n\nThis file contains additional information about building Coin on Mac OS X.\nFor more information on getting started, known issues, and more, see\nhttps://github.com/coin3d/coin/wiki/Mac%20information%20page.\n\n\nBuilding Coin\n=============\n\nBuilding Coin should be straightforward:\n\n  ./configure \u0026\u0026 make \u0026\u0026 sudo make install\n\nSee the file INSTALL for details. If any of these stages fails, it's a bug\nin Coin. Please let us know about this, and we will be glad to fix it.\n\nPlease make sure that you have the latest version of Apple's developer\ntools installed before building Coin.\n\n\nBinary SDKs\n===========\n\nPrecompiled binaries of the Coin framework can be found on our ftp server[0]\nor through the www.coin3d.org webserver.\n\n\nUsing Coin\n==========\n\nIf you want to use Coin on the Mac, you need a user interface binding. \nAt the moment you have four basic options for this:\n                                    \n  0. Use the native Cocoa binding, Sc21. See\n     http://www.coin3d.org/mac/Sc21/ for more information.\n                                            \n  1. Use Qt/Mac. This requires Trolltech's Qt toolkit, which you can\n     get from [1]. After downloading and installing Qt, you can\n     download and build SoQt.\n                           \n  2. Use X11 for Mac OS X, and Qt/X11. See the README.MACOSX file in\n     the SoQt source code repository for instructions.\n\n  3. Create your own OpenGL canvas and use this for rendering. This is\n     not the easiest way to go, since it involves quite some\n     programmatic overhead. The glutiv.cpp example (see [3]) shows how\n     this can be done using the GL utility toolkit (\"GLUT\").\n\n\nMac OS X version specific notes\n===============================\n\nMac OS 10.0.x\n-------------\n\nMac OS 10.0.x is not supported. Mac OS 10.0.x contained several grave\nproblems and should be considered more like a \"public beta\". If you\nare still using 10.0.x, I strongly suggest you upgrade to \u003e= 10.1 --\nthere have been huge steps forward in performance and stability. \n\nCoin will probably work on Mac OS 10.0.x, though, if you build it\nyourself. Note that if you build Coin on a MacOS 10.1 system and want\nto use the library on 10.0.x, you will have to use the -flat_namespace\nlinker switch. (Modify the LDFLAGS environment variable to do that.)\nDo not do this unless you are sure you what you are doing and have\nread (and fully understood) Apple's Release Note concerning two-level\nnamespace executables[4].\n\n\nMac OS 10.2 (\"Jaguar\")\n----------------------\n\nIf you are upgrading from Mac OS 10.1 to Mac OS 10.2 (\"Jaguar\"), you\nmust recompile your Coin library. This is due to the fact that the\ndeveloper tools for Mac OS 10.2 are based on gcc.3.1, as opposed to\ngcc-2.95 in 10.1. These two compilers are not ABI compatible - meaning\nthat you have to rebuild _all_ your C++ libraries.\n\nNote that there are several bugs in the developer tools that came with\nthe original Mac OS 10.2 CDs, so you should install the most current\nversion of the developer tools (available on the ADC website).\n\nPlease consult the Coin/Mac FAQ [2] for more information about issues\nrelated to Mac OS X versions, ABI compatibility, etc.\n\n\nMac OS 10.3 (\"Panther\")\n-----------------------\n\nIf you are upgrading to Mac OS 10.3 (Panther), you should (again)\nrecompile your Coin library. Apple changed the default compiler to\nfrom gcc-3.1 in 10.2 to gcc-3.3 in 10.3 These two compilers are not\nABI compatible - meaning that you have to rebuild _all_ your C++\nlibraries. \n\nPlease consult the Coin/Mac FAQ [2] for more information about issues\nrelated to Mac OS X versions, ABI compatibility, etc.\n\n\nMac OS 10.4 (\"Tiger\") and 10.5 (\"Leopard\")\n------------------------------------------\n\nNo particular notes for these at this time.\n\n\nThe Inventor framework\n======================\n\nBy default, Coin will be set up as Mac OS X framework. Frameworks are a\nconcept central to Mac OS X, packing a dynamic shared library with the\nnecessary resources for this library, like header files, images, and\ndocumentation. You can link against a framework by using the \"-framework\" \ncompiler option. Please refer to the Apple developer documentation [5] for \nmore information about frameworks.\n\nSince Coin is an Open Inventor implementation, the framework is named\n\"Inventor\", not Coin. Following Apple's recommendation for 3rd-party\nframeworks, the Inventor.framework is installed in /Library/Frameworks.\n\nWhat this means, basically, is that instead of\n\"cc -I/path/to/Coin/include -L/path/to/Coin/lib -lCoin -lGL -lGLU -o foo foo.cpp\",\nthe commandline for building applications again Coin would be something like this:\n\"cc -framework Inventor -framework OpenGL -o foo foo.cpp\"\n\nYou can of course still use the coin-config script, which takes care of\nall this (see man coin-config(1) for more information).\n\nIf you want to disable the creation of the framework and install Coin as\nstandalone shared library, you can use the configure option\n\n--without-framework\n\nwhich will install libCoin.dylib into $prefix/lib and the headers into\n$prefix/include (/usr/local/lib and /usr/local/include by default).\n\nNote that the configure option \"-with-framework\" is intended for\ndebugging purposes (to install as a framework on non-Macintosh systems)\nonly. You do not need it when you build Coin/Mac as a framework (as is \nthe default).\n\n\nProject Builder/Xcode support\n=============================\n\nYou can use the Inventor.framework like any of Apple's frameworks in\nProject Builder or Xcode by just dragging and dropping it into your\nproject settings. \n\n(Mac OS 10.2 users: See also the problem note on  __Znwm below.)\n\n\nCommon problems (and solutions)\n===============================\n\nThe following is a list of problem related to *building* Coin on Mac\nOS X. For information on potential issues related to *using* Coin/Mac,\nplease refer to the FAQ [2].\n\n\no Conflicting installations of Inventor framework and library\n  -----------------------------------------------------------\n\nIf you get strange errors concerning missing or conflicting\ndeclarations in header files, make sure you do not have an old\ninstallation of Inventor on your system, with the header files being\ninstalled somewhere in gcc's search paths, such as\n/usr/include/Inventor/. Unfortunately, gcc searches its default\ninclude path _before_ trying to use the headers that come with the\nframework. Removing the old header files should solve the problem.\n                                                         \n\no Directory names with spaces\n  ----------------------------\n\nThere seem to be some problems with Automake when the path to the Coin\nconfigure directory contains spaces. A typical warning you would get in\nthis case is \"configure: WARNING: `missing' script is too old or\nmissing.\" -- Things seem to work in spite of this, but I wouldn't rely\non it.\n\nUntil this has been fixed, I suggest the obvious workaround of not \nhaving any spaces in the path leading to Coin.\n\n\no \"Undefined symbol: __Znwm\" \n  -------------------------- \n\n(Note: This is not relevant for versions of Coin \u003e= 2.0.1 , but is\nkept here for reference.)\n\nThe problem was caused by the fact that when building Coin, we\nspecifically set -L/usr/lib/gcc/darwin/default/private/, forcing the\nversion of libstdc++.dylib in that directory to be linked in. Now when\nthe user compiled an application in Project Builder, the application\nlinked against a *different* version of libstdc++, and when the\napplication was run, that version of the library was used, leading to\nan undefined symbol error.  The only reason for having\n-L/usr/lib/gcc/darwin/default/private/ in the first place was a\nworkaround that is now no longer necessary and has since been removed\nfrom Coin.\n\nIf you build a project using Coin in Project Builder, you might get a \nrun time error message about __Znwm being undefined. Mac OS 10.2 comes \nwith two version of libstdc++, so you must tell it which ones to use - \nnamely the same one used for building Coin. Adding the following to the\nlinker commandline solves the problem: \n\n    \"-L/usr/lib/gcc/darwin/default/private/\"\n\nIf you do not have a /usr/lib/gcc/darwin/default/private/ directory on\nyour machine, then you probably have a buggy version of the Apple\ndeveloper tools. Please either install the December2002 developer\ntools (suggested) or in the\nfollowing order: \n1. Install July Dev tools\n2. Install August Dev Tools update\n3. Install October Dev Tools update\n\n\n\nIf you have any further problems when trying to configure and build Coin \non Mac OS X, please let us know. \n\n\nReferences:\n\n[0] ftp://ftp.coin3d.org/pub/coin/bin/macosx/\n[1] http://www.trolltech.com/download/qt/mac.html\n[2] http://www.coin3d.org/mac/faq.html\n[3] http://www.coin3d.org/source/viewcvs/examples/bindings/glutiv.cpp\n[4] http://developer.apple.com/documentation/ReleaseNotes/DeveloperTools/TwoLevelNamespaces.html\n[5] http://developer.apple.com/documentation/MacOSX/Conceptual/BPFrameworks/Concepts/WhatAreFrameworks.html\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoin3d%2Fcoin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoin3d%2Fcoin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoin3d%2Fcoin/lists"}