BYR-Mathematical-Art-Challenge

北邮人数学艺术挑战赛，灵感来自Tweetable Mathematical Art

介绍 Description

生成一幅图像的本质是一个建立一个屏幕空间到颜色空间的映射关系，因此我们完全可以使用一段很短的代码来生成一幅具有艺术性的图像。本次挑战中，我们要求参赛者使用限定长度的代码来编写三个函数（R、G、B），最终生成一张大小512x512，时长6秒、25FPS（总共150帧）的动态图像GIF。

举个例子，上面的JuliaSet图像我们可以用下面的代码生成：

unsigned char RD(int x, int y, float t) {v2 c=v2(-0.8,cos(t)*0.2);v2 z = v2(2.0*x/f(N-1)-1.0,2.0*(f(y)/N-0.5));int i=0;while(no2(z)<20&&i<50){v2 s=v2(z.x*z.x-z.y*z.y,z.x*z.y*2.0);z=a2(c,s);i++;}return 255-i*5.1;}
unsigned char GR(int x, int y, float t) {v2 c=v2(-0.8,cos(t)*0.2);v2 z = v2(2.0*x/f(N-1)-1.0,2.0*(f(y)/N-0.5));int i=0;while(no2(z)<20&&i<50){v2 s=v2(z.x*z.x-z.y*z.y,z.x*z.y*2.0);z=a2(c,s);i++;}return 255-i*5.1;}
unsigned char BL(int x, int y, float t) {v2 c=v2(-0.8,cos(t)*0.2);v2 z = v2(2.0*x/f(N-1)-1.0,2.0*(f(y)/N-0.5));int i=0;while(no2(z)<20&&i<50){v2 s=v2(z.x*z.x-z.y*z.y,z.x*z.y*2.0);z=a2(c,s);i++;}return 255-i*5.1;}

上面的每个函数体中的代码长度都只有170个字符。

等待提交截止后，我们会在北京邮电大学校内发起投票，让各位同学们票选出自己心目中最优秀的作品。

规则 Rules

首先，本次比赛使用MIT开源协议，所有提交者必须以某种形式（GitHub/Gitee）开源自己的代码（最简单的办法：Fork这个仓库，然后编写自己的代码）。提交时，需要提交自己的仓库地址和渲染结果。比赛允许查阅资料，但是不允许抄袭、滥用的行为，相关行为一经举报查证，成绩将立即作废。

我们已经把各个语言对应的startup文件放置在对应名字的文件夹下了，你要做的是按照规则编写对应的渲染函数：RD、GR、BL，分别对应红、绿、蓝三个颜色分量。

其中，渲染函数形如（以C/C++语言为例）：

unsigned char RD(int x, int y, float t);

前两个参数为像素的横坐标和纵坐标，第三个参数为时间，以秒为单位，我们会以24fps（一秒均匀截取24帧）为标准传入第三个参数；输出的是颜色分量的值。前两个参数为整数，范围{0,1, 2...,511}，第三个参数为浮点数，范围[0.0, 6.0]；输出为范围在[0, 255]的整数。

我们的一些常规要求如下：

如果没有特别说明，每个函数的长度不超过200个字符（不包括函数的声明部分，只包含函数体，不包括最外层的大括号）
只能使用math.h标准库和我们提供的一些数学方法，不能使用额外的库文件
不允许读取外部文件，只能使用程序过程化地生成图片
你只能在这三个函数的函数体中编写代码，不能额外添加函数（但是你可以在函数中编写闭包函数）

我们支持用以下这些语言提交，其中对于各个不同的语言的额外要求如下：

赛程

比赛主要分为三个阶段：参赛提交阶段、展示投票阶段和评奖阶段

参赛提交阶段 2022年9月9日（星期五）12时00分-2022年9月14日（星期三）23时59分
展示投票阶段 2022年9月10日（星期六）12时00分-2022年9月15日（星期三）23时59分
评奖阶段 9月17日（星期日）

提交 Submission

在你开始编写代码时，请Fork这个仓库，并且clone你Fork的仓库进行代码的编写。

在你完成代码的编写后，将你的代码推送至fork出的仓库后，向这个仓库发起pull request，pull request的标题为你的作品名，pull request的内容是你从这个网站获取的签名（注意，你必须正确填写你的Github ID），这里有一份示例PR可以参考。

发起fork之后，我们的参赛工作者将会即时审核你的代码是否符合要求，并且为你的PR挂上label，随后你的提交将会经由我们设置的Github Action自动提交至服务器上，你可以在这里查看你的提交。

快速构建脚本

我们提供了一个脚本run.py来自动进行编译、运行、编码等工作以减轻参赛者的心智负担，我们假定你的计算机上已经下载了python运行环境。

编写对应的语言代码
安装python依赖pip install -r requirements_dev.txt
依照说明修改脚本中的language变量
运行脚本（linux和macos用户需要自行安装ffmpeg，windows下会自动从服务器拉取可用的ffmpeg二进制预编译exe）python run.py
项目根目录下即可找到result.mp4

提示 Hint

对于参加比赛的选手，我们有如下的建议和提示：

你可以在debug的时候任意改变渲染的图像数目和FPS来加速你的debug速度，但是记住请务必按照比赛要求提交渲染结果，否则记录无效
你可以在编写的时候正常定义函数，提交的时候再进行代码压缩

一些有用的参考资料 Reference

太极图形课：程序动画：生成你的第一个二维动画
ShaderToys
Inigo QuilezIntro to Painting with Maths

协议 LICENSE

此{项目, 比赛}遵循MIT开源协议。

BYRIO/BYR-Mathematical-Art-Challenge