openFrameworks README

The project's README from github.com/openframeworks/openFrameworks. As one markdown file: README.md.

openFrameworks

openFrameworks is a C++ toolkit for creative coding. If you are new to OF, welcome!

Build status

Platform Master branch Stable branch
Windows MSYS2 Build status Build status
Windows Visual Studio Build status Build status
Linux 64 & Arm Linux Build Status Linux Build Status
Emscripten Emscripten Build Status Emscripten Build Status
macos macos Build Status macos Build Status
iOS & tvOS iOS tvOS Build Status iOS tvOS Build Status

folder structure

This release of OF comes with several folders:

docs has some documentation around OF usage, per platform things to consider, etc. You should definitely take a look in there; for example, if you are on OSX, read the osx.md. apps and examples are where projects go -- examples contains a variety of projects that show you how to use OF, and apps is where your own projects will go. libs contains the libraries that OF uses, including the openframeworks core itself. addons are for additional functionality that's not part of the core. export is for DLLs and dylibs that need to be put in each compiled project. The scripts folder has the templates and small scripts for automating OF per platform. project generator is a GUI based tool for making new projects - this folder is only there in packaged releases.

One idea that's important is that OF releases are designed to be self-contained. You can put them anywhere on your hard drive, but it's not possible to mix different releases of OF together, so please keep each release (0.8.0, 0.8.1) separate. Projects may generally work from release to release, but this is not guaranteed. Because OF is self-contained, there's extensive use of local file paths (ie, ../../../) throughout OF. It's important to be aware of how directories are structured. A common error is to take a project and move it so that it's a level below or above where it used to be compared to the root of OF. This means that links such as ../../../libs will break.

Get involved

The openframeworks forum:

http://forum.openframeworks.cc/

is a warm and friendly place. Please ask or answer a question. The most important part of this project is that it's a community, more than just a tool, so please join us! Also, this is free software, and we learn so much about what is hard, what doesn't make sense, what is useful, etc. The most basic questions are acceptable here! Don't worry, just join the conversation. Learning in OF is social, it's hard to do it alone, but together we can get far!

Our GitHub site is active:

https://github.com/openframeworks/openFrameworks

if you have bugs or feature requests, consider opening an issue. If you are a developer and want to help, pull requests are warmly welcome. Please read the contributing guide for guidelines:

https://github.com/openframeworks/openFrameworks/blob/master/CONTRIBUTING.md

We also have a developer's mailing list, which is useful for discussing issues around the development and future of OF.

Developers

To grab a copy of openFrameworks for your platform, check the download page on the main site.

If you are working with the Git repository, the stable branch of the OF repository corresponds to the most recent release, with a few important differences:

  1. The release includes a simple openFrameworks project generator.
  2. This GitHub repository contains code and libs for all the platforms, but the releases are done on a per-platform basis.
  3. This GitHub repository has no project files for the different examples. They are generated automatically for each release using a tool in apps/projectGenerator/.
  4. There are no external dependencies in this repository, you can download them using the download_libs.sh script for each platform in the particular platform folder inside scripts.

If you want to work with the openFrameworks GitHub repository, you need to download the external dependencies and you should use the project generator to create project files for all the code in examples/. To generate the project files with the project generator enable the 'Advanced Options' in the settings tab, then use 'Update Multiple' to update the projects for the examples/ folder path in the repo.

To set up the project generator submodule within the OF repo, use the command git submodule init then git submodule update whilst inside the openFrameworks repo.

For more info on working with the Project Generator, for per-platform readmes, and more information, see the documentation.

Versioning

openFrameworks uses Semantic Versioning, although strict adherence will only come into effect at version 1.0.0.

openFrameworks (openframeworks/openFrameworks)

Searching Database…

10.4K ·GitHub
OpenFrameworks
Что это такое?Это кроссплатформенный набор инструментов для креативного кодинга на C++, развиваемый сообществом — с его помощью создают интерактивные проекты с графикой, звуком, видео и компьютерным зрением.
То есть это библиотека, которую я подключаю к своему проекту, или что-то большее?Это самодостаточный набор инструментов, внутри которого вы и работаете: в скачиваемый пакет входят ядро openFrameworks, сторонние библиотеки, аддоны и примеры проектов, а свои приложения вы кладёте в его папку apps.
Как его запустить?Скачайте stable-релиз (или nightly) для своей ОС с openframeworks.cc/download, следуйте руководству по настройке для вашей платформы в папке docs, затем соберите один из встроенных примеров.
Есть ли подводные камни, о которых стоит знать заранее?Релизы нельзя смешивать, а проекты обращаются к набору инструментов по относительным путям вроде ../../../libs — если переместить проект на уровень выше или ниже внутри папки OF, связи сломаются.
Мне нужно быть опытным C++-разработчиком, чтобы им пользоваться?Вы пишете на C++, поэтому какой-никакой опыт программирования пригодится — но проект держится на своём сообществе: в комплекте есть примеры для обучения, а на форуме приветствуются даже самые базовые вопросы.
Какие платформы он поддерживает?Windows (MSYS2 или Visual Studio), macOS, Linux 64-bit и Arm (Raspberry Pi), iOS, tvOS и Android, а также сборки через Emscripten, которые работают в браузере.
Можно ли бесплатно использовать его в своих проектах?В README он назван свободным ПО, но конкретная лицензия там не указана; на GitHub лицензия значится как нестандартная.
Как начать свой собственный проект?Воспользуйтесь project generator — это графический инструмент, который входит в готовые сборки и создаёт файлы проекта для вашей платформы. Свои проекты живут в папке apps, рядом с примерами.
Можно ли работать прямо с репозиторием на GitHub, а не со сборкой?Да, но потребуется подготовка: в репозитории нет внешних зависимостей — для каждой платформы в папке scripts есть свой downloadlibs.sh — и нет файлов проектов для примеров; они генерируются для каждого релиза.
Для каких проектов он подходит?Для работы с интерактивными медиа: графика на OpenGL, звук, видео и компьютерное зрение (OpenCV входит в число его библиотек) — от настольных приложений до iOS и Android и браузерных сборок через Emscripten.
What are similar projects?SFML, bgfx, xbmc, Infinite, vlc, kivy, assimp, opencv
Which topics is it in?emscripten, osx, opencv, multimedia, opengl, creative-coding, computer-graphics, raspberry-pi, graphics, audio, video, cpp
Creator
openframeworks
Size
2.1 GB
Stars
10.4K
Updated
CommitOct 17ReleasenightlyOct 17
Age
16y
Commits · 90 Days