생각하는개발자

타원의 방정식

래머 — Thu, 21 Mar 2019 18:12:52 +0900

y^2 = b^2 * (1 - (x^2 / a^2))

NodeMcu TFT lcd 연결

래머 — Wed, 6 Feb 2019 18:56:25 +0900

LCD NODEMCU

SDD/MISO D6

LED 3.3V

SCK D5

SDI/MOIS D7

DC/RS 임의의핀

RESET 임의의핀

CS 임의의핀

GND

VCC

스파인 캐릭터 유니티용으로 익스포트 하기

래머 — Tue, 22 Jan 2019 20:07:32 +0900

스파인 메뉴의 Export(또는 단축키 Ctrl + E) 를 눌러 익스포트 창을 엽니다.

아래와 같은 창이 열립니다.

익스포트창의 왼쪽 상단의 JSON을 선택합니다.

Create atals에 체크합니다.

Create atals 체크박스옆의 셋팅 버튼을 눌러서 텍스쳐팩커 설정창을 엽니다.

설정창 오른쪽 아래에 Atalas extension이라 이름 붙여진 부분에 .atals.txt 라고 설정되어 있는지 확인합니다. 다르게 되어 있는경우 .atals.txt로 바꿔줍니다.

Ok버튼을 눌러서 텍스쳐 팩커 설정창을 닫습니다.

다시 익스포트창으로 돌아와 Output folder 폴더를 지정해줍니다.

익스포트를 눌러 리소스를 익스포트 합니다.

익스포트한 폴더로 이동하면 각기 확장자가 allas.txt, json, png 3개의 파일이 있습니다.

위에서 익스포트한 리소스를 유니티에서 사용하기전에 먼저 스파인 유니티 런타임 패키지를 유니티 프로젝트에 임포트 해야 합니다.

아래 링크에서 스파인 런타임 유니티용 패키지를 다운로드 하고 유니테 프로젝트에 임포트 해주세요.

https://esotericsoftware.com/files/runtimes/unity/spine-unity-3_7-2019-01-21.unitypackage

스파인에서 익스포트해서 나온 3개의 파일을 유니티 프러젝트 패널에 드래그 해서 임포트 합니다.

관리를 위해서 유니티의 프로젝트 패널에서 캐릭터용 폴더를 따로 만들어서 넣어주세요.

스파인 유니티용 런타임 패키지를 설치 했다면 스파인이 자동으로 필요한 리소스들을 생성해줄겁니다.

xxx_SkeletonData 형태의 이름을 가진 애셋을 씬뷰 또는 하이어라키 패널에 드래그 하면 메뉴가 출력되는데 상단의 SkeletonAnimation을 눌러주면 씬에 임포트한 캐릭터를 배치할 수 있습니다.

브라우저 새로고침

래머 — Thu, 20 Sep 2018 14:50:38 +0900

크롬 : 개발자도구가 열린상태에서 새로고침을 꾹 누르면 나오는 메뉴에서 캐시비움 가능

오페라 : 도구 -> 설정 -> 고급설정 -> 검색 데이터 지우기 에서 삭제

파이어폭스 : Shift + 새로고침

웹소켓 채팅서버

래머 — Wed, 13 Jun 2018 00:38:38 +0900

웹소켓 기반 채팅 서버 예제입니다.

서버는 c#기반 슈퍼웹소켓 이용했고, 모노기반에서 우분투 리눅스 데몬으로 작동합니다. VS2017용 솔류션입니다.

클라이언트는 코코스 크리에이터입니다.

HTML5 지원하는 브라우져에서 테스트 가능합니다.

소스 다운로드(Git)

먼저 서버 접속을 통해서 채팅서버에 접속후 채팅할 수 있습니다.

아래에 아무것도 표시되지 않는다면 브라우저에 의해서 클라이언트가 차단된경우일 수 있습니다.

안전하지 않은 스크립트소스 로드 허용하시면 플레이 가능합니다.

유니티 연습

래머 — Tue, 12 Jun 2018 14:01:56 +0900

유니티 까먹지 않기 위한 연습프로젝트 입니다.

1:1 pvp 입니다. 컴퓨터와 서로 공격을 주고 받으면서 이기는게 목표인 단순한 샘플예제입니다.

HTML5를 지원하는 브라우져에서 플레이 할 수 있습니다.

A,S,D,F키를 통해서 이동, 마우스 왼버튼이 공격입니다.

소스코드는 여기에서 다운로드 할 수 있습니다.(Git)

유닉스 소켓프로그래밍

래머 — Sat, 2 Jun 2018 07:38:15 +0900

BeeJ's Guide to Network Programming.

인터넷 소켓 활용(v.1.5.4, 17-May-1998)

http://www.ecst.csuchico.edu/~beej/guide/net 번역 : 박성호(tempter@fourthline.com),1998/8/20

--------------------------------------------------------------------------------

시작

소켓 프로그램이 어렵나요?

그냥 맨페이지만 보고서는 알아내기가 좀 어럽나요?

뭔가 있어보이는 인터넷 프로그램을 만들고 싶지만 bind()를 호출하고 connect()

를 호출하고 이런 저런 구조체를 뒤지고 할 시간이 없나요?

글쎄요, 제가 그 지겨운걸 다 해놓았고요, 여러분과 이 정보를 공유하고 싶군요.

바로 찾아오셨습니다.

이 문서가 바로 평균적인 C 프로그래머에게 네트워크 프로그램에 관련된 정보를

드릴겁니다.

--------------------------------------------------------------------------------

대상

이 문서는 안내서이지 리퍼런스는 아닙니다.

아마도 소켓 프로그래밍을 처음 시작하면서 어디서부터 해야 할지 모르는

사람들에게 도움이 될겁니다.

물론 어떤 의미에서도 이 글은 소켓 프로그래밍에 관한 완벽한 안내서는 아닐

겁니다.

단지 도저히 의미를 알 수 없던 맨페이지들을 조금씩 이해하게 되기만 바랄

뿐입니다.

--------------------------------------------------------------------------------

사용도구

대부분의 코드는 리눅스 PC에서 GNU의 gcc를 이용하여 컴파일 되었습니다.

또한 HPUX에서 gcc를 이용해서 컴파일 된다는 것도 확인했습니다.

그러나 모든 작은 코드들이 테스트 된것은 아니라는 것을 기억하시기 바랍니다.

(이하 존칭 생략)

--------------------------------------------------------------------------------

내용

소켓이란 무엇인가.

두가지 종류의 소켓

네트워크 이론과 저수준의 알수없는 것들

struct s--이걸 모르면 외계인이 지구를 파괴할걸~~

순서 바꾸기

IP주소 와 활용법

socket()--파일 기술자를 잡아라

bind()--나는 어떤 포트에 연결되었나?

connect()--어이 거기!

listen()--누가 전화좀 걸어주지

accept()--포트3490에 전화걸어주셔서 감사합니다.

send() and recv()--말좀 해봐!

sendto() and recvfrom()--말좀해봐! 데이터그램방식

close() and shutdown()--꺼지쇼!

getpeername()--누구십니까?

gethostname()--난 누구인가?

DNS--"whitehouse.gov", - "198.137.240.100"

클라이언트 서버의 배경

간단한 스트림서버

간단한 스트림클라이언트

데이터그램 소켓

블로킹

select()--동기화된 중복입출력, 대단하군!

참고사항

주의사항 및 연락처

--------------------------------------------------------------------------------

소켓이란 무엇인가.

소켓이란 단어는 많이 들었을 것이다.

그리고 아마도 그 소켓이 정확히 무엇인가에 대하여 궁금해 하기도 했을 것이다.

소켓은 정규 유닉스 파일 기술자를 이용하여 다른 프로그램과 정보를 교환하는

방법을 의미한다.

뭐라고라?

좋다. 아마도 유닉스를 잘하는 사람들이 이렇게 얘기하는 것을 들어본 적이

있을 것이다. "유닉스에서는 모든게 파일로 되어있군!" 실제로 그들이 얘기하는

것은 모든 유닉스 프로그램들이 어떤 종류의 입출력을 하더라도 파일 기술자를

통해서 하게 된다는 것이다.

파일 기술자는 사실 열려진 파일을 의미하는 정수일 뿐이다.

그러나 그 파일은 네트워크가 될수도 있고 FIFO, 파이프, 터미널, 실제

디스크상의 파일이 될수도 있으며 그 밖의 무엇도 다 된다는 것이다.

유닉스의 모든것은 파일이다! 따라서 당신이 인터넷을 통하여 멀리 떨어진 다른

프로그램과 정보를 교환하기 위해서는 파일 기술자를 이용하면 된다는 것이다.

믿으쇼~

"똑똑이 양반, 그 파일 기술자는 도대체 어떻게 만드는거요?" 라는게 당신의

맘속에 지금 막 떠오른 질문일 것이다.

여기에 대답이 있다. socket()을 호출하면 소켓 기술자를 얻게 되고

send(), recv()등의 소켓에 관련된 함수를 호출하여 정보를 교환할 수 있다.

(man send, man recv를 해봐도 됨)

"잠깐!" 이렇게 이의를 제기하겠지.

"그 소켓 기술자가 파일 기술자라면 도대체 왜 read(),write()를 쓰면

안되는거요?" 짧게 말하면 맞다.

그러나 send(),recv()를 쓰는 것이 여러모로 네트워크를 통한 정보전달을

제어하기에 도움이 된다는 것이다.

다음은 뭔가? 소켓의 종류는? DARPA 인터넷 주소(인터넷 소켓),

경로명과 지역노드(유닉스 소켓), CCITT X.25 주소(X.25 소켓, 그냥 무시해도 됨)

등이 있고 아마도 당신이 쓰는 유닉스에 따라서 더 많은 종류의 소켓들이 있을

것이다. 이 문서는 첫번째 (인터넷 소켓) 하나만 설명할 것이다.

--------------------------------------------------------------------------------

두가지 종류의 소켓

인터넷 소켓에 두가지 종류가 있나? 그렇다. 음..사실은 거짓말이다.

좀 더있긴 하지만 겁을 주고 싶지 않기 때문에 이것 두가지만 이야기 하는 것이다.

RAW 소켓이라는 매우 강력한 것도 있으며 한번 봐두는 것도 좋다.

두가지 종류는 무엇인가? 하나는 스트림소켓 이고 다른 하나는 데이터그램

소켓이다. 이후에는 SOCK_STREAM, SOCK_DGRAM으로 지칭될 것이다.

데이터그램 소켓은 비연결 소켓이라고도 한다.

(비록 그 소켓에서도 원한다면 connect()를 사용할 수도 있다.

connect()절을 참조할것)

스트림 소켓은 양측을 신뢰성있게 연결해 주는 소켓이다.

만약 두가지 아이템을 이 소켓을 통하여 보낸다면 그 순서는 정확히

유지될 것이다. 에러까지 교정된다. 만일 에러가 생긴다면 당신 실수이고

당신실수를 막는 방법은 여기서 설명하지 않을 것이다.

스트림 소켓은 어디에 쓰이는가? 아마도 텔넷이라고 들어봤을 것이다.

들어봤느뇨? 그게 이 소켓을 쓴다.

입력한 모든 글자는 그 순서대로 전달이 되야 하는 경우이다.

사실 WWW사이트의 포트 80에 텔넷으로 접속하여 "GET pagename" 을 입력하면

HTML 화일의 내용이 우르르 나올 것이다.

어떻게 스트림 소켓이 이정도의 정확한 전송 품질을 갖추게 되는가?

이 소켓은 TCP를 이용하기 때문이다.

(Transmission Control Protocol, RFC-793에 무척 자세하게 나와있다.)

아마도 TCP 보다는 TCP/IP를 더 많이 들어봤을 것이다.

앞부분은 바로 이 TCP이고 뒷부분의 IP는 인터넷 라우팅을 담당하는 프로토콜이다.

괜찮군~ 데이터그램 소켓은 어떤가? 왜 비연결이라고 하는지?

내용에 무슨 관련이 있는지? 왜 신뢰도가 떨어지지?

사실 이 소켓의 경우 당신이 데이터그램을 보낸다면 정확히 도착할 수도 있다.

또는 패킷들의 순서가 바뀌어서 도착할 수도 있다. 그러나 만약 도착한다면

그 내용은 사실 정확한 것이다.

데이터그램 소켓 또한 라우팅에는 IP를 이용하지만 TCP는 이용하지 않는다.

사실은 UDP(RFC-768)을 이용한다.

연결을 안하는가? 스트림 소켓에서처럼 열려있는 연결을 관리할 필요가 없는

것이다. 그냥 데이터 패킷을 만들어서 목적지에 관련된 IP헤더를 붙여서

발송하기만 하면 되는 것이다. 연결이 필요없다. 보통 tftp나 bootp 에 사용되는

것이다.

좋아! 그러면 데이터 패킷이 도착하지 않을지도 모르는 이런 걸 어떻게 실제

프로그램에서 사용하지? 사실 프로그램들은 UDP위에 그 나름대로의 대책을

갖추고 있는 것이다. 예를 들면 tftp같은 경우에는 하나의 패킷을 보낸 후에

상대편이 잘 받았다는 응답 패킷이 올때까지 기다리는 것이다.

만약 일정시간(예를 들면 5초)동안 응답이 없으면 못받은 것으로 간주하고

다시 보내고, 다시 보내고 응답이 있으면 다음 패킷을 보내고 하게 되는것이다.

이 잘받았다는 응답(ACK reply) 방식은 사실 SOCK_DGRAM을 사용할 경우 매우

중요하다.

--------------------------------------------------------------------------------

네트워크 이론과 저아래의 알수없는 것들

간단히 프로토콜의 레이어에 대해서 언급을 했지만(UDP위에 나름대로의

대책 어쩌구) 이제는 실제로 네트워크가 어떻게 작동하는 지를 알아볼 때가

되었고 실제로 SOCK_DGRAM이 어떻게 구성되는 지를 알아볼 필요가 있을 것같다.

사실 이 절은 그냥 넘어가도 된다.

여러분~ 이제는 데이타 캡슐화에 대하여 배우겠어요~ 사실 이것은 매우 중요하다.

얼마나 중요하냐면 우리 학교에서 네트워크 코스를 통과하려면 반드시 알아야

하는 사항이기 때문이다. (흠..) 내용은 이렇다. 데이터 패킷이 만들어지면 먼저

첫번째 프로토콜(tftp 프로토콜)에 필요한 머리말과 꼬리말이 붙는다.

이렇게 한번 캡슐화된 내용은 다시 두번째 프로토콜(UDP)에 관련된 머리말과

꼬리말이 다시 붙게 된다.

그 다음에는 IP, 그 다음에는 마지막으로 하드웨어 적인 계층으로서 이더넷

프로토콜로 캡슐화가 되는 것이다.

다른 컴퓨터에서 이 패킷을 받게 되면 하드웨어가 이더넷 헤더를 풀고 커널에서

IP와 UDP 헤더를 풀고 tftp 프로그램에서 tftp헤더를 풀고 하여 끝으로 원래의

데이터를 얻게 되는 것이다.

이제 드디어 악명높은 계층적 네트워크 모델(Layered Network Model)을 얘기할

때가 된것 같다.

이 모델은 다른 모델들에 비해서 네트워크의 시스템을 기술하는 측면에서 많은

이점이 있다.

예를 들면 소켓 프로그래밍을 하는 경우 더 낮은 계층에서 어떤 물리적인

방식(시리얼인지 thin ethernet인지 또는 AUI방식인지)으로 전달되는 지에 대하여

전혀 신경을 쓰지 않고도 작업이 가능해 질 수 있다는 것이다. 실제 네트워크

장비나 토폴로지는 소켓 프로그래머에게는 전혀 관계없는 분야이다.

더이상 떠들지 않고 다음 계층들을 일러 주는데 만일 네트워크 코스에서 시험을

보게 될 경우라면 외우는 것이 좋을 것이다.

Application

Presentation

Session

Transport

Network

Data Link

Physical

물리적 계층(Physical layer)는 하드웨어(시리얼, 이더넷등) 이다.

어플리케이션 계층은 상상할 수 있듯이 물리적 계층의 반대편 끝이다.

이 계층을 통하여 사용자는 네트워크와 접촉하게 되는 것이다.

사실 이 모델은 자동차 수리 설명서 처럼 실질적인 뭔가를 할 수 있기에는

너무나 일반적인 얘기이다.

유닉스의 경우를 들어 보다 실질적인 얘기를 해 본다면,

Application Layer (telnet, ftp, etc.)

Host-to-Host Transport Layer (TCP, UDP)

Internet Layer (IP and routing)

Network Access Layer (was Network, Data Link, and Physical)

이러한 계층으로 살펴 본다면 아까의 데이터 캡슐화가 각각 어떤 계층에 속하는

가를 알 수 있을 것이다.

이렇게 많은 작업이 하나의 데이터 패킷을 만드는데 동원되는 것이다.

이 내용을 당신이 데이터의 패킷 머리부분에 몽땅 타이핑 해 넣어야 한다는

얘기다. (물론 농담이다.) 스트림 소켓의 경우 데이터를 내보내기 위해 해야 할 일은 오직 send()를 호출하는 것 뿐이다. 데이터 그램의 경우에는 원하는 방식으로 데이터를 한번 캡슐화하고 (tftp방식등) sendto()로 보내버리면 되는 것이다.커널이 전송계층과 인터넷 계층에 관련된 캡슐화를 하고 나머지는 하드웨어가 한다. 아~ 첨단 기술!!

이것으로 간단한 네트워크 이론은 끝이다. 참, 라우팅에 관해서 하고 싶던 얘기들을 하나도 안했다. 흠, 하나도 없다. 정말이지 라우팅에 관해서 하나도 얘기하지 않을 것이다. 라우터가 IP헤더를 벗겨내서 라우팅 테이블을 참조하여 어쩌구 저쩌구...만일 정말로 여기에 관심이 있다면 IP RFC를 참조할 것이며 만약 거기에 대해서 하나도 알지 못한다면! 생명에 지장은 없다.

--------------------------------------------------------------------------------

struct S

결국은 여기까지 왔군. 드디어 프로그래밍에 관한 얘기를 할 때이다. 이 절에서는 실제로 꽤나 이해하기 어려운 소켓 인터페이스에서 쓰이는 여러가지 데이터 타입에 대한 얘기를 할 예정이다.

먼저 쉬운것. 소켓 기술자이다.소켓 기술자의 데이터 형은

int

이다. 그냥 보통 int이다. (정수형)

뭔가 좀 이상하더라도 그냥 참고 읽기 바란다. 이것은 알아야 한다. 정수에는 두 바이트가 있는데 상위 바이트가 앞에 있거나 또는 하위 바이트가 앞에 있게 된다. 앞의 경우가 네트워크 바이트 순서이다. 어떤 호스트는 내부적으로 네트워크 바이트 순서로 정수를 저장하는 경우도 있으나 안그런 경우가 많다. 만일 NBO라고 언급된 정수가 있다면 함수를 이용하여 (htons()함수) 호스트 바이트 순서로 바꾸어야 한다. 만약 그런 언급이 없다면 그냥 내버려 둬도 된다.

첫번째 구조체, struct sockaddr. 이 구조체는 여러가지 형태의 소켓 주소를 담게된다.

struct sockaddr {

unsigned short sa_family; /* address family, AF_xxx */

char sa_data[14]; /* 14 bytes of protocol address */

};

sa_family 는 여러가지가 될 수 있는데, 이 문서에서는 그중에서 "AF_INET"인 경우만 다루게 된다. sa_data 는 목적지의 주소와 포트번호를 가지게 된다. 약간 비실용적이군.

sockaddr 구조체를 다루기 위해서는 다음과 같은 parallel structure를 만들어야 한다. ("in"은 인터넷을 의미한다.)

struct sockaddr_in {

short int sin_family; /* Address family */

unsigned short int sin_port; /* Port number */

struct in_addr sin_addr; /* Internet address */

unsigned char sin_zero[8]; /* Same size as struct sockaddr */

};

이 구조체는 각각의 항을 참조하기가 좀더 쉬운 것 같다. 주의할 점은 sin_zero배열은 sockaddr 과 구조체의 크기를 맞추기 위해서 넣어진 것이므로 bzero()나 memset()함수를 이용하여 모두 0으로 채워져야 한다. 또한 꽤 중요한 점인데, 이 구조체는 sockaddr 의 포인터를 이용하여 참조될 수 있고 그 반대도 가능하다는 것이다. 따라서 socket()함수가 struct sockaddr * 를 원하더라도 struct sockaddr_in을 사용할 수 있고 바로 참조할 수도 있는 것이다. 또한 sin_family는 sa_family에 대응되는 것이며 물론 "AF_INET"로 지정되어야 하며 sin_port, sin_addr은 네트워크 바이트 순서로 되어야 하는 점이 중요한 것이다.

그러나! 어떻게 struct in_addr sin_addr 전체가 NBO가 될 수 있는가? 이 질문은 살아남은 가장 뭣같은 유니온인 struct in_addr 에 대한 보다 신중한 검토가 필요할 것같다.

/* Internet address (a structure for historical reasons) */

struct in_addr {

unsigned long s_addr;

};

음.. 이것은 유니온 "이었었"다. 그러나 그런 시절은 지나갔다. 시원하게 없어졌군! 따라서 만약 "ina"를 struct sockaddr_in형으로 정의해 놓았다면 ina.sin_addr.s_addr 로 NBO 상태의 4바이트 인터넷 어드레스를 정확하게 참조할 수 있을 것이다. 만약 사용하는 시스템이 struct in_addr에 그 끔찍한 유니온을 아직도 사용하고 있더라도 #defines S 덕분에 위에 한것과 마찬가지로 정확하게 참조할 수는 있을 것이다.

--------------------------------------------------------------------------------

순서 바꾸기

이제 다음 절로 왔다. 네트워크와 호스트 바이트 순서에 대해서 말이 너무 많았고 이제는 실제 움직일 때라고 본다.

좋다. 두가지 형태의 변환이 있는데 하나는 short(2 바이트)와 long(4바이트)의 경우이다. 이 함수들은 unsigned변수에서도 잘 작동된다. 이제 short변수를 호스트 바이트 순서에서 네트워크 바이트 순서로 변환하는 경우를 보자. 호스트의 h 로 시작해서 to 를 넣고 네트워크의 n 을 넣은 후 short의 s 를 넣는다. 그래서 htons()이다. (읽기는 호스트 투 네트워크 쇼트이다.)

너무 쉬운가?

사실 h,n,s,l 의 어떤 조합도 사용가능하다. (물론 너무 바보스러운 조합을 하지는 않겠지..예를 들어 stolh, 쇼트 투 롱 호스트?? 이런건 없다. 적어도 이 동네에서는없다.) 있는 것들은 다음과 같다.

htons()--"Host to Network Short"

htonl()--"Host to Network Long"

ntohs()--"Network to Host Short"

ntohl()--"Network to Host Long"

아마도 이제 상당히 많이 알게된 것같이 생각들을 할 것이다. "char의 바이트 순서를 어떻게 바꾸지?(역자주: 이 질문은 아마 의미없는 질문으로 한 것 같은데 답도 없고 더이상의 언급이 없는 것으로 보아 빼고 싶은 부분이다.)" 또는 "염려마, 내가 쓰는 68000 기계는 이미 네트워크 바이트 순서로 정수를 저장하니까 변환할 필요는 없어 " 라고 생각할 수도 있을 것이다. 그러나 꼭 그렇지만은 않다. 그렇게 작성된 프로그램을 다른 기계에서 작동시킨다면 당연히 문제가 발생할 것이다. 여기는 유닉스 세계고 이기종간의 호환성은 매우 중요한 것이다. 반드시 네트워크에 데이터를 보내기 전에 네트워크 바이트 순서로 바꿔서 보낸다는 것을 기억할 지어다.

끝으로 sin_addr, sin_port는 네트워크 바이트 순서로 기록하는데 왜 sin_family는 안 그러는가? 답은 간단하다. sin_addr과 sin_port는 캡슐화되어 네트워크로 전송되어야 하는 변수인 것이다. 따라서 당연히 NBO여야 한다. 그러나 sin_family는 시스템 내부에서 커널에 의해서만 사용되는 변수이며 네트워크로 전송되지 않는 것이므로 호스트 바이트 순서로 기록되어야 하는 것이다.

--------------------------------------------------------------------------------

IP주소는 무엇이며 어떻게 다루는가?

다행스럽게도 IP주소를 산정해 주는 수많은 함수들이 있으며 따라서 4바이트의 long변수에 직접 계산해서 << 연산자를 이용해서 집어넣어야 하는 수고는 할 필요가 없다.

먼저 struct sockaddr_IN ina가 정의되어 있고 132.241.5.10 이 IP 주소이며 이 값을 변수에 넣어야 한다고 가정해 보자. inet_addr()함수가 바로 이럴때 사용하는 것이다. 그 함수는 숫자와 점으로 구성된 IP주소를 unsigned long 변수에 집어 넣어 준다. 다음과 같이 하면 된다.

ina.sin_addr.s_addr = inet_addr("132.241.5.10")

inet_addr()는 결과값으로 이미 NBO인 값을 돌려주며 굳이 htonl()을 또 사용할 필요는 없다는 점에 주의해야 한다. 멋지군!

그러나 위의 짤막한 코드는 그렇게 견실해 보이진 않는다. 왜냐하면 inet_addr()은 에러의 경우 -1을 돌려주게 되며 unsigned long에서 -1은 255.255.255.255를 의미한다. 이는 인터넷 브로드캐스트 어드레스가 된다. 나쁜 녀석. 항상 에러 처리를 확실히 하는것이 좋다.

좋다. 이제 IP주소를 long에 넣는것은 알았는데 그 반대는 어떻게 할 것인가? 만약에 값이 들어있는 struct in_addr은 가지고 있는데 이를 숫자와 점으로 표시하려면? 이 경우는 inet_ntoa()를 쓰면 된다.(ntoa 는 네트워크 투 아스키이다.)

printf("%s",inet_ntoa(ina.sin_addr));

위의 코드는 IP주소를 프린트 해 줄것이다. 이 함수는 long 변수가 아니라 struct in_addr 를 변수로 받아 들인다는 점을 주의해야 한다. 또한 이 함수는 char 에 대한 포인터를 결과로 돌려 주는데 이는 함수내에 static 한 공간에 저장되며 따라서 매번 함수가 호출될 때마다 이 포인터가 가리키는 곳의 값은 변화한다는 것이다. 즉 예를 들면,

char *a1, *a2;

a1 = inet_ntoa(ina1.sin_addr); /* this is 198.92.129.1 */

a2 = inet_ntoa(ina2.sin_addr); /* this is 132.241.5.10 */

printf("address 1: %s\n",a1);

printf("address 2: %s\n",a2);

의 출력은 이렇게 나올 것이다.

address 1: 132.241.5.10

address 2: 132.241.5.10

만약에 이 값을 저장해야 할 필요가 있다면 strcpy()를 이용하여 고유의 char 배열에 저장해야 할 것이다.

이절에서 얘기할 것은 다 했다. 나중에 "whitehouse.gov" 문자열을 해당하는 IP주소로 바꾸는 법을 알려 줄것이다. (DNS절 참조)

--------------------------------------------------------------------------------

socket() ; 파일 기술자를 잡아라

안하면 맞을것 같아서 socket() 시스템 호출에 대해서 얘기해야만 할것같다. 이걸 잠깐 보자.

#include <sys/types.h>

#include <sys/socket.h>

int socket(int domain, int type, int protocol);

그런데 이 변수들은 또 뭔가? 첫째 domain 은 struct sockaddr_in 에서처럼 AF_INET 로 지정하면 된다. 다음 type 은 SOCK_STREAM이나 SOCK_DGRAM으로 지정하면 된다. 끝으로 protocol은 0으로 지정하면 된다. (언급하지 않았지만 더 많은 domain과 더 많은 type 이 있다는 것을 기억하라. socket() 맨페이지를 참고하고 또한 protocol 에 대해서 좀더 알려면 getprotobyname()을 참조하면 된다.)

socket()은 바로 나중에 사용할 소켓 기술자인 정수값을 돌려주며 에러시에는 -1을 돌려주게 된다. 전역변수인 errno에 에러값이 기록된다. (perror()의 맨페이지를 참조할것.)

--------------------------------------------------------------------------------

bind() ; 나는 어떤 포트에 연결되었나?

일단 소켓을 열게 되면 이 소켓을 현재 시스템의 포트에 연결시켜 주어야 한다. (이 작업은 보통 listen()함수를 이용해서 외부의 접속을 대기할 때 시행되며 일반적으로 머드게임 사이트들이 telnet *.*.*.* 6969 로 접속하라고 할때도 이 작업을 시행했다는 의미이다. ) 만약에 그저 다른 호스트에 연결하기만 할 예정이라면 그냥 connect()를 사용하여 연결만 하면 되고 이 작업은 필요가 없다.

아래는 bind() 시스템 호출의 선언이다.

#include <sys/types.h>

#include <sys/socket.h>

int bind(int sockfd, struct sockaddr *my_addr, int addrlen);

sockfd는 socket()함수에서 얻은 소켓 기술자이며 my_addr은 IP 주소에 관한 정보(즉, IP 주소와 포트번호)를 담고 있는 struct sockaddr 에 대한 포인터 이고 addrlen은 그 구조체의 사이즈(sizeof(struct sockaddr))이다.

휴~~ 한방에 받아들이기에는 좀 그렇군. 예를 보자.

#include <string.h>

#include <sys/types.h>

#include <sys/socket.h>

#define MYPORT 3490

main()

{

int sockfd;

struct sockaddr_in my_addr;

sockfd = socket(AF_INET, SOCK_STREAM, 0); /* do some error checking! */

my_addr.sin_family = AF_INET; /* host byte order */

my_addr.sin_port = htons(MYPORT); /* short, network byte order */

my_addr.sin_addr.s_addr = inet_addr("132.241.5.10");

bzero(&(my_addr.sin_zero), 8); /* zero the rest of the struct */

/* don't forget your error checking for bind(): */

bind(sockfd, (struct sockaddr *)&my_addr, sizeof(struct sockaddr));

몇가지 주의할 점은 my_addr.sin_port 는 my_addr.sin_addr.s_addr과 같이 NBO이다. 또한 헤더화일은 각각의 시스템마다 다를 수 있으므로 각자의 시스템의 맨 페이지를 참고해야 할 것이다.

마지막으로 bind()와 관련해서 주소나 포트의 지정이 때에 따라서 자동화 될 수도 있다는 것을 언급해야 할 것같다.

my_addr.sin_port = 0; /* choose an unused port at random */

my_addr.sin_addr.s_addr = INADDR_ANY; /* use my IP address */

my_addr.sin_port를 0으로 지정하면 자동으로 사용되지 않고 있는 포트 번호를 지정해 줄것이며 my_addr.sin_addr.s_addr를 INADDR_ANY로 지정할 경우 현재 작동되고 있는 자신의 IP주소를 자동으로 지정해 주게 된다.

만약 여기서 약간만 주의를 기울였다면 INADDR_ANY를 지정할 때 NBO로 바꾸는 것을 빼먹은 것을 눈치챌 것이다. 나아쁜~~. 그러나 난 내부정보를 알고 있지롱. 사실은 INADDR_ANY는 0이다. 0은 순서를 바꾸어도 0인것이다. 그러나 순수이론적인 측면에서 INADDR_ANY가 그러니까 12정도인 세계가 존재한다면 이 코드는 작동 안할것이다. 그래서? 난 상관없다. 정 그렇다면,

my_addr.sin_port = htons(0); /* choose an unused port at random */

my_addr.sin_addr.s_addr = htonl(INADDR_ANY); /* use my IP address */

이제는 믿기 어려울 정도로 이식가능한 코드가 되었다. 다만 지적하고 싶은 것은 작동하는 데에는 아무 문제가 없다는 점이다.

bind()또한 에러가 났을때 -1을 돌려주며 errno에 에러의 코드가 남게 된다.

bind()를 호출할 때 주의할점 : 절대 제한선 아래로 포트번호를 내리지 말라는 것이다. 1024 아래의 번호는 모두 예약되어 있다. 그 위로는 65535까지 원하는 대로 쓸 수가 있다. (다른 프로그램이 쓰고 있지 않은 경우에 한해서..)

또 하나의 작은 꼬리말 : bind() 를 호출하지 않아도 되는 경우가 있다. 만일 다른 호스트에 연결 (connect())하고자 하는 경우에는 자신의 포트에는 (텔넷의 경우처럼)전혀 신경 쓸 필요가 없다. 단지 connect()를 호출하기만 하면 알아서 bind가 되어 있는지를 체크해서 비어있는 포트에 bind를 해준다.

--------------------------------------------------------------------------------

connect() ; 어이~ 거기~

이제 잠깐만 마치 자신이 텔넷 프로그램인 것처럼 생각해 보기로 하자. 당신의 사용자는 명령하기를 (TRON영화에서처럼.. (역자: 난 그 영화 안 봤는데..)) 소켓 기술자를 얻어오라 했고 당신은 즉시 socket()를 호출했다. 다음에 사용자는 132.241.5.10 에 포트 23(정규 텔넷 포트번호)에 연결하라고 한다. 윽, 이젠 어떻게 하지?

다행스럽게도 당신(프로그램)은 connect()절(어떻게 연결하는가)를 심각하게 읽고 있으며 당신의 주인을 실망시키지 않으려고 미친듯이 읽어나가는 중이로다~~

connet()는 다음과 같이 선언한다.

#include <sys/types.h>

#include <sys/socket.h>

int connect(int sockfd, struct sockaddr *serv_addr, int addrlen);

sockfd는 이제는 친숙해진 소켓 기술자이며 serv_addr은 연결하고자 하는 목적지인 서버의 주소와 포트에 관한 정보를 담고 있는 struct sockaddr 이며 addrlen은 앞에서 이야기 한것과 같이 그 구조체의 크기이다.

뭔가 좀 이해가 갈듯 하지 않은가? 예를 들어 보자.

#include <string.h>

#include <sys/types.h>

#include <sys/socket.h>

#define DEST_IP "132.241.5.10"

#define DEST_PORT 23

main()

{

int sockfd;

struct sockaddr_in dest_addr; /* will hold the destination addr */

sockfd = socket(AF_INET, SOCK_STREAM, 0); /* do some error checking! */

dest_addr.sin_family = AF_INET; /* host byte order */

dest_addr.sin_port = htons(DEST_PORT); /* short, network byte order */

dest_addr.sin_addr.s_addr = inet_addr(DEST_IP);

bzero(&(dest_addr.sin_zero), 8); /* zero the rest of the struct */

/* don't forget to error check the connect()! */

connect(sockfd, (struct sockaddr *)&dest_addr, sizeof(struct sockaddr));

다시 말하건데 connect()의 결과값을 한번 체크해 봐야 한다. 에러일 경우 -1을 돌려주고 errno를 세팅하기 때문이다.

또한 bind()를 호출하지 않은 것에 주의해야 한다. 기본적으로 여기서는 자신의 포트 번호에는 결코 관심이 없기 때문이다. 단지 어디로 가는가만이 중요하다. 커널이 알아서 로컬 포트를 선정해 줄 것이며 우리가 연결하고자 하는 곳에서는 자동으로 이 정보를 알게 될 것이다.

--------------------------------------------------------------------------------

listen() ; 누가 전화좀 걸어주지~

이제 보조를 바꾸어서, 만약에 어디론가 연결하고자 하는 것이 아니라 외부로부터의 접속을 대기해서 접속이 올 경우 어떤 방식으로든지 간에 처리를 해 주어야 하는 경우라면 어찌 할 것인가. 이 작업은 두 단계로 이루어진다. 먼저 listen()을 해야 되고 그 다음에 accept()를 해야 된다는 것이다.

listen()은 상당히 간단하지만 약간의 설명은 필요하다.

int listen(int sockfd, int backlog);

sockfd는 보통의 소켓 기술자이며 backlog는 접속대기 큐의 최대 연결 가능 숫자이다. 그건 또 뭔 얘기인가? 외부로부터의 연결은 이 대기 큐에서 accept()가 호출될 때까지 기다려야 한다는 것이며 숫자는 바로 얼마나 많은 접속이 이 큐에 쌓여질 수 있는가 하는 것이다. 대부분의 시스템은 이 숫자를 조용하게 20정도에서 제한하고 있으며 보통은 5에서 10 사이로 지정하게 된다.

또 다시 listen()도 에러의 경우 -1을 돌려주며 errno를 세팅한다.

아마 상상할 수 있듯이 listen()보다 앞서서 bind()를 호출해야 하며 만약에 bind()가 되지 않으면 우리는 랜덤하게 지정된 포트에서 외부의 접속을 기다려야 한다. (포트를 모르고서 누가 접속할 수 있겠는가? 우엑~~) 따라서 외부의 접속을 기다리는 경우라면 다음 순서대로 작업이 진행되어야 하는 것이다.

socket();

bind();

listen();

/* accept() goes here */

위의 것만으로도 이해가 갈만하다고 보고 예제에 대신하겠다. (accept()절에 보다 괜찮은 코드가 준비되어 있다.) 이 모든 sha-bang(역자: 이 뭐꼬?)중에서 가장 헷갈리는 부분은 accept()를 부르는 부분이다.

--------------------------------------------------------------------------------

accept() ; 포트 3490에 전화걸어주셔서 감사합니다.

준비! accept()를 호출하는 것은 뭔가 좀 수상하긴 하다. 과연 뭐가 벌어지는가? 저 멀리 떨어진 곳에서 누군가가 connect()를 호출하여 당신이 listen()을 호출하고 기다리는 포트에 접속을 시도한다. 그들의 연결은 바로 accept()가 호출되기 까지 큐에서 바로 당신이 accept()를 호출하여 그 연결을 지속하라고 명령할 때까지 대기하게 된다. 그러면 이 함수는 오로지 이 연결을 위한 완전히 신제품 소켓 파일 기술자를 돌려주게 된다. 갑자기 당신은 하나값으로 두개의 소켓 기술자를 갖게 되는 것이다. 원래의 것은 아직도 그 포트에서 연결을 listen()하고 있다. 또 하나는 새롭게 창조되어 드디어 send()와 recv()를 할 준비가 되도록 하는 것이다.

드디어 여기까지 왔다! 감격~~

선언은 아래와 같다.

#include <sys/socket.h>

int accept(int sockfd, void *addr, int *addrlen);

sockfd는 listen()하고 있는 소켓의 기술자이다. 뻔하지 뭐.. addr은 로컬 struct sockaddr_in의 포인터이다. 여기에 들어온 접속에 관한 정보가 담겨지게 되고 이를 이용해서 어느 호스트에서 어느 포트를 이용해서 접속이 들어왔는지를 알 수 있게 된다. addrlen은 로컬 정수 변수이며 이 정수에는 struct sockaddr_in의 크기가 미리 지정되어 있어야 한다. 이 숫자보다 더 많은 바이트의 정보가 들어오면 accept()는 받아 들이지 않을 것이며 적데 들어온다면 addrlen의 값을 줄여 줄 것이다.

accept() 는 에러가 났을 경우에 어떻게 한다고? -1을 돌려주고 errno 를 세팅한다.

아까 맨치로 한방에 받아들이기에는 좀 그러니까 예제를 열심히 읽어 보자.

#include <string.h>

#include <sys/types.h>

#include <sys/socket.h>

#define MYPORT 3490 /* the port users will be connecting to */

#define BACKLOG 10 /* how many pending connections queue will hold */

main()

{

int sockfd, new_fd; /* listen on sock_fd, new connection on new_fd */

struct sockaddr_in my_addr; /* my address information */

struct sockaddr_in their_addr; /* connector's address information */

int sin_size;

sockfd = socket(AF_INET, SOCK_STREAM, 0); /* do some error checking! */

my_addr.sin_family = AF_INET; /* host byte order */

my_addr.sin_port = htons(MYPORT); /* short, network byte order */

my_addr.sin_addr.s_addr = INADDR_ANY; /* auto-fill with my IP */

bzero(&(my_addr.sin_zero), 8); /* zero the rest of the struct */

/* don't forget your error checking for these calls: */

bind(sockfd, (struct sockaddr *)&my_addr, sizeof(struct sockaddr));

listen(sockfd, BACKLOG);

sin_size = sizeof(struct sockaddr_in);

new_fd = accept(sockfd, &their_addr, &sin_size);

이제 new_fd를 이용해서 send()와 recv()를 이용할 수 있다는 것이다. 만약 원한다면 더이상의 연결을 받아들이지 않고 하나의 연결만 이용하기 위해서 close()를 이용하여 원래의 sockfd를 막아 버릴 수도 있다.

--------------------------------------------------------------------------------

send(), recv() ; 말좀해봐~

이 두 함수는 스트림 소켓이나 연결된 데이터그램 소켓위에서 정보를 주고 받을때 사용하는 것들이다. 만약 보통의 비연결 데이터그램 소켓을 사용한다면 sendto()와 recvfrom()절을 참조하도록 한다.

send() 호출의 선언은 아래와 같다.

int send(int sockfd, const void *msg, int len, int flags);

sockfd는 socket()를 통해서 얻었거나 accept()를 통해서 새로 구한, 데이터를 보낼 소켓의 기술자이며, msg는 보낼 데이터를 가리키는 포인터, len은 보낼 데이터의 바이트 수 이며 flags 는 그냥 0으로 해야 한다. (플래그에 관한 보다 자세한 내용은 send()의 맨 페이지를 참조할것.)

약간의 예제가 다음과 같다.

char *msg = "Beej was here!";

int len, bytes_sent;

len = strlen(msg);

bytes_sent = send(sockfd, msg, len, 0);

send()는 결과값으로 보내진 모든 바이트 수를 돌려주는데 이것은 보내라고 한 숫자보다 작을 수도 있다. 가끔은 보내고자 하는 데이터의 크기가 미처 감당하지 못할 만한 숫자인 경우도 있으며 이 경우 send()는 자기가 감당할 수 있는 숫자만큼만 보내고 나머지는 잘라 버린후 당신이 그 나머지를 다시 보내 줄 것으로 기대하는 것이다. 만약에 보내라고 한 데이터의 크기보다 작은 숫자가 결과값으로 돌아 왔다면 그 나머지 데이터를 보내는 것은 전적으로 당신의 책임인 것이다. 그나마 희소식은 데이터의 사이즈가 작다면 (1k 이내라면) 아마도 한번에 모두 보낼 수 있을 것이다. 또한 에러의 경우 -1을 돌려주며 errno를 세팅한다.

recv()의 경우도 상당히 유사하다.

int recv(int sockfd, void *buf, int len, unsigned int flags);

sockfd는 읽어올 소켓의 기술자이며 buf는 정보를 담을 버퍼이다. len은 버퍼의 최대 크기이고 flags는 0으로 세팅해야 한다. (자세한 flags의 정보는 recv() 맨 페이지를 참조할것.)

recv()는 실제 읽어들인 바이트 숫자를 돌려주며 에러의 경우는 -1, errno를 세팅한다.

쉬웠을까? 쉬웠지.. 이제 당신은 스트림 소켓을 이용해서 데이터를 보내고 받을 수 있게 되었다. 우와~ 유닉스 네트워크 프로그래머네~~

--------------------------------------------------------------------------------

sendto(), recvfrom() ; 말좀해봐~ 데이터 그램 방식

괜찮은걸, 이라고 말하고 있는줄로 생각하겠다. 그런데 데이터그램에 관한 나머지는 어딨지? 노프라블레모~ 아미고~(역자: 터미네이터2가 생각나는군~~) 이제 할 것이다.

데이터그램 소켓은 연결을 할 필요가 없다면 데이터를 보내기 전에 주어야 할 나머지 정보는 어떻게 주어야 하는가? 맞다. 목적지의 주소를 알려주어야 한다. 여기에 예제가 있다.

int sendto(int sockfd, const void *msg, int len, unsigned int flags,

const struct sockaddr *to, int tolen);

보다시피 이 함수는 두가지 부가정보가 더 들어간 것 이외에는 기본적으로 send()와 동일하다. to 는 struct sockaddr의 포인터이며(아마도 struct sockaddr_in) 여기에는 목적지의 주소와 포트번호가 담겨 있어야 할 것이다. tolen은 그 구조체의 크기인 것이다.

send()와 마찬가지로 sendto()도 보내어진 데이터의 바이트수를 결과로 돌려주며(실제 보내라고 준 데이터의 크기보다 작을지도 모르는), 에러의 경우 -1을 돌려준다.

비슷하게 recvfrom()도 아래와 같다.

int recvfrom(int sockfd, void *buf, int len, unsigned int flags

struct sockaddr *from, int *fromlen);

역시 이것도 두가지 변수가 더 주어지게 된다. from은 데이터를 보내는 장비의 주소와 포트를 담고 있는 struct sockaddr 이며 fromlen은 로컬 정수변수로서 구조체의 크기가 세팅되어 있어야 한다. 함수가 호출된 뒤에는 fromlen에는 실제 from의 크기가 수록되게 된다.

recvfrom()은 실제 받은 데이터의 바이트수를 돌려주며 에러의 경우는 -1, errno를 세팅하게 된다.

만약 connect()를 이용하여 데이터그램 소켓을 연결한 후의 상황이라면 간단히 send(), recv() 를 사용해도 상관 없으며 소켓 인터페이스는 자동으로 목적지와 소스에 관한 정보를 함수에 추가해서 작동되게 될 것이다.

--------------------------------------------------------------------------------

close(), shutdown() ; 꺼지쇼.

휴~~ 하루종일 데이터를 보내고 받았더니..이제는 소켓을 닫을 때가 된 것이다. 이건 쉽다. 정규 파일 기술자에 관한 close()를 사용하면 되는 것이다.

close(sockfd);

이것으로 더이상의 입출력은 불가능 해지며 누구든지 원격지에서 이 소켓에 읽고 쓰려고 하는 자는 에러를 받게 될 것이다.

약간 더 세밀한 제어를 위해서는 shutdown()을 사용하면 된다. 이것을 이용하면 특정방향으로의 통신만을 끊을 수도 있게 된다.

int shutdown(int sockfd, int how);

sockfd는 소켓 기술자이며 how는 다음과 같다.

0 - 더이상의 수신 금지

1 - 더이상의 송신 금지

2 - 더이상의 송수신 금지(close()와 같은 경우)

shutdown() 은 에러의 경우 -1을 돌려주며 errno를 세팅한다.

황송하옵게도 연결도 되지않은 데이터그램 소켓에 shutdown()을 사용한다면 단지 send(), recv()를 사용하지 못하게만 만들 것이다. connect()를 사용한 경우에만 이렇게 사용할 수 있다는 것을 기억해야 한다. (역자: 그렇다면 sendto, recvfrom은 사용이 된다는 얘기인가??테스트가 필요할듯.)

암것도 아니군.

--------------------------------------------------------------------------------

getpeername() ; 누구십니까?

이 함수는 되게 쉽다.

너무 쉬워서 절을 따로 만들 필요가 없지않나 고민했지만 여기 있는걸 보니까..

getpeername()은 상대편 쪽 스트림 소켓에 누가 연결되어 있는가를 알려준다.

#include <sys/socket.h>

int getpeername(int sockfd, struct sockaddr *addr, int *addrlen);

sockfd는 연결된 스트림 소켓의 기술자이며 addr은 상대편의 정보를 담게 될 struct sockaddr(또는 struct sockaddr_in)의 포인터 이며 addrlen은 정수를 가리키는 포인터로서 구조체의 크기가 지정되어 있어야 한다.

에러의 경우는 -1을 돌려주고 errno를 세팅한다. (외우겠군.)

일단 주소를 알게되면 inet_ntoa()나 gethostbyaddr()을 이용하여 좀더 많은 정보를 알아낼 수 있게 되지만 상대편의 login name을 알게되는 것은 아니다. (만일 상대편에 ident 데몬이 돌고 있다면 알아낼 방법이 없는 것은 아니지만 이 내용은 이 글의 취지를 벗어나는 내용이므로 RFC-1413을 참조하라고 말하고 싶다.)

--------------------------------------------------------------------------------

gethostname() ; 난 누구인가?

getpeername()보다 더 쉬운 것이 이 함수이다. 결과로 프로그램이 돌고 있는 컴퓨터의 이름을 알려준다. 이름은 gethostbyname()을 이용하여 로컬 장비의 IP주소를 알아내는데 사용될 수도 있다.

뭐가 더 재미있는가? 몇가지 생각해 볼 수 있는데 이 문서에는 적절하지 않은 내용이다(역자: 과연 뭘까..되게 궁금하네..). 어쨌거나,

#include <unistd.h>

int gethostname(char *hostname, size_t size);

hostname은 문자열의 포인터이며 함수가 돌려주는 값을 담게 될 변수이다. size는 그 문자열의 크기이다.

성공적이면 0을, 에러의 경우 -1을 리턴하고 errno를 세팅한다.

--------------------------------------------------------------------------------

DNS ; whitehouse.gov - 198.137.240.100

모르는 사람을 위하여 DNS는 Domain Name Service 라는 것을 먼저 얘기 하겠다. 간결하게 얘기한다면 DNS에다가 사람이 읽을수 있는 주소를 말해주면 DNS는 bind,connect,sendto,어쨌거나 IP주소가 필요한 것들에서 사용할 수 있는 IP주소를 돌려준다. 즉 누군가가 이렇게 입력했다면

$ telnet whitehouse.gov

telnet 은 connect()에 사용하기 위해서 198.137.240.100이라는 IP주소를 찾아내게 된다. 그런데 어떻게 그렇게 하는 것인가? gethostbyname()을 사용하면 된다.

#include <netdb.h>

struct hostent *gethostbyname(const char *name);

보다시피 결과로 struct hostent의 포인터가 돌아온다. 그 구조는 아래와 같다.

struct hostent {

char *h_name;

char **h_aliases;

int h_addrtype;

int h_length;

char **h_addr_list;

};

#define h_addr h_addr_list[0]

각 필드에 대한 설명은 다음과 같다.

h_name - 호스트의 공식적인 이름

h_aliases - 호스트의 별명으로서 NULL 로 끝맺음된다.

h_addrtype - 주소의 종류, 보통 AF_INET

h_length - 주소의 바이트 수

h_addr_list - 0으로 끝나는 네트워크 주소들, NBO로 되어 있다.

h_addr - h_addr_list속의 첫번째 주소

gethostbyname()은 위의 구조체의 포인터를 돌려주게 되며 에러의 경우 NULL을 돌려준다. errno는 세팅되지 않고 h_errno가 세팅이 된다. (아래의 herror()참조)

그런데 이걸 어떻게 사용하는가? 보통 컴퓨터 매뉴얼들 처럼 독자앞에 정보를 마구 쌓아놓은 것만으로는 부족한 법이다. 이 함수는 사실 보기보다는 쓰기가 쉬운 편이다.

예제를 보자.

#include <stdio.h>

#include <stdlib.h>

#include <errno.h>

#include <netdb.h>

#include <sys/types.h>

#include <netinet/in.h>

int main(int argc, char *argv[])

{

struct hostent *h;

if (argc != 2) { /* error check the command line */

fprintf(stderr,"usage: getip address\n");

exit(1);

}

if ((h=gethostbyname(argv[1])) == NULL) { /* get the host info */

herror("gethostbyname");

exit(1);

}

printf("Host name : %s\n", h->h_name);

printf("IP Address : %s\n",inet_ntoa(*((struct in_addr *)h->h_addr)));

return 0;

}

gethostbyname()에서는 errno가 세팅되지 않는 까닭으로 perror()를 사용할 수 없고 herror()을 사용해야 한다.

간단히 호스트의 이름을 담고 있는 스트링을 gethostbyname()함수에 넣어 줌으로써 바로 struct hostent 를 얻게 되는 것이다.

남아있는 한가지 수상한 점은 위의 방법으로 어떻게 주소를 숫자와 점으로 출력할 것인가 하는 문제이다. h->h_addr 은 문자 포인터( char *) 인데 inet_ntoa()는 변수로서 struct in_addr 을 원하기 때문이다. 따라서 h->h_addr 을 struct in_addr * 으로 형변환을 하고 결과값을 얻기 위해 다시 역참조 하면 된다는 것이다.

클라이언트-서버의 배경

요즘은 클라이언트-서버가 판치는 세상이죠~~

네트워크에 관한 모든 것은 서버 프로세스를 요청하는 클라이언트 프로세스로서

다루어진다.

텔넷을 이용하여 23번 포트에 접속하는 (클라이언트)것은

서버프로그램(telnetd)을 작동시키게 되는 것이며 이 서버 프로그램은 들어오는

각종 신호를 받아들여서 당신의 텔넷 접속을 위하여 로그인 프롬프트를 주게

되는 것이다. 등등..

그림2. 클라이언트-서버간의 관계

클라이언트와 서버간의 정보 교환의 모델이 그림에 잘 나와있다.

주목할점은 클라이언트와 서버간에는 SOCK_STREAM이든, SOCK_DGRAM이든지간에

같은 것으로만 된다면 의사소통이 된다는 것이다.

좋은 예들은 telnet-telnetd, ftp-ftpd, 또는 bootp-bootpd 등이다.

ftp를 쓴다면 반드시 상대편에 ftpd가 돌고 있다는 것이다.

보통 호스트에는 하나의 서버 프로그램이 돌고 있게 된다. 그리고 그 서버는

fork()를 이용하여 다중의 클라이언트를 받게 되는 것이다.

기본적인 루틴의 구조는 다음과 같다. 서버는 접속을 대기하다가 accept()를

호출하게 되며 그 때 fork()를 이용하여 자식 프로세스를 만들어내어 그 접속을

처리하게 된다. 이것이 바로 다음에 소개될 예제 서버 프로그램의 구조이다.

--------------------------------------------------------------------------------

간단한 스트림 서버

이 서버가 하는 일은 오직 스트림 접속을 하게 되는 모든 클라이언트에게

"Hello, World!\n"을 출력해 주는 것이다. 이 서버를 테스트하기 위해서는

하나의 윈도우에서 이 서버를 실행시켜 놓고 다른 윈도우에서 텔넷 접속을

시도해 보는 것이다.

$ telnet remotehostname 3490

hostname 은 서버 프로그램이 작동된 호스트의 이름이다.

서버 프로그램 코드

#include <stdio.h>

#include <stdlib.h>

#include <errno.h>

#include <string.h>

#include <sys/types.h>

#include <netinet/in.h>

#include <sys/socket.h>

#include <sys/wait.h>

#define MYPORT 3490 /* the port users will be connecting to */

#define BACKLOG 10 /* how many pending connections queue will hold */

main()

{

int sockfd, new_fd; /* listen on sock_fd, new connection on new_fd */

struct sockaddr_in my_addr; /* my address information */

struct sockaddr_in their_addr; /* connector's address information */

int sin_size;

if ((sockfd = socket(AF_INET, SOCK_STREAM, 0)) == -1) {

perror("socket");

exit(1);

}

my_addr.sin_family = AF_INET; /* host byte order */

my_addr.sin_port = htons(MYPORT); /* short, network byte order */

my_addr.sin_addr.s_addr = INADDR_ANY; /* auto-fill with my IP */

bzero(&(my_addr.sin_zero), 8); /* zero the rest of the struct */

if (bind(sockfd, (struct sockaddr *)&my_addr, sizeof(struct sockaddr)) \

== -1) {

perror("bind");

exit(1);

}

if (listen(sockfd, BACKLOG) == -1) {

perror("listen");

exit(1);

}

while(1) { /* main accept() loop */

sin_size = sizeof(struct sockaddr_in);

if ((new_fd = accept(sockfd, (struct sockaddr *)&their_addr, \

&sin_size)) == -1) {

perror("accept");

continue;

}

printf("server: got connection from %s\n", \

inet_ntoa(their_addr.sin_addr));

if (!fork()) { /* this is the child process */

if (send(new_fd, "Hello, world!\n", 14, 0) == -1)

perror("send");

close(new_fd);

exit(0);

}

close(new_fd); /* parent doesn't need this */

while(waitpid(-1,NULL,WNOHANG) > 0); /* clean up child processes */

}

이 코드는 문법상의 단순함을 위하여 하나의 커다란(내 생각에) main()에 모든

것이 들어가 있다. 만약에 이것을 잘게 잘라서 작은 여러개의 함수로 구성을

하는것이 좋다고 생각된다면 그래도 된다.

다음의 클라이언트 코드를 이용한다면 이 서버로부터 문자열을 받아 낼수도 있다.

--------------------------------------------------------------------------------

간단한 스트림 클라이언트

이녀석은 서버보다 더 쉬운 코드이다.

이 프로그램이 하는 일은 명령행에서 지정된 주소에 3490번 포트에 접속하여

서버가 보내는 문자열을 받는 것 뿐이다.

#include <stdio.h>

#include <stdlib.h>

#include <errno.h>

#include <string.h>

#include <netdb.h>

#include <sys/types.h>

#include <netinet/in.h>

#include <sys/socket.h>

#define PORT 3490 /* the port client will be connecting to */

#define MAXDATASIZE 100 /* max number of bytes we can get at once */

int main(int argc, char *argv[])

{

int sockfd, numbytes;

char buf[MAXDATASIZE];

struct hostent *he;

struct sockaddr_in their_addr; /* connector's address information */

if (argc != 2) {

fprintf(stderr,"usage: client hostname\n");

exit(1);

}

if ((he=gethostbyname(argv[1])) == NULL) { /* get the host info */

herror("gethostbyname");

exit(1);

}

if ((sockfd = socket(AF_INET, SOCK_STREAM, 0)) == -1) {

perror("socket");

exit(1);

}

their_addr.sin_family = AF_INET; /* host byte order */

their_addr.sin_port = htons(PORT); /* short, network byte order */

their_addr.sin_addr = *((struct in_addr *)he->h_addr);

bzero(&(their_addr.sin_zero), 8); /* zero the rest of the struct */

if (connect(sockfd, (struct sockaddr *)&their_addr, \

sizeof(struct sockaddr)) == -1) {

perror("connect");

exit(1);

}

if ((numbytes=recv(sockfd, buf, MAXDATASIZE, 0)) == -1) {

perror("recv");

exit(1);

}

buf[numbytes] = '\0';

printf("Received: %s",buf);

close(sockfd);

return 0;

}

이 클라이언트를 작동하기에 앞서서 서버를 작동시켜놓지 않았다면

connect()함수는 "Connection refused"를 돌려주게 될것이다. 쓸만하군!

--------------------------------------------------------------------------------

데이터그램 소켓

이에 관해서는 그다지 얘기할 것이 많지 않다. 따라서 그냥 두개의 프로그램을

보여 주겠다.

listener는 호스트에 앉아서 4950포트에 들어오는 데이터 패킷을 기다린다.

talker는 지정된 호스트의 그 포트로 뭐든지 간에 사용자가 입력한 데이터를

보낸다.

listener.c

#include <stdio.h>

#include <stdlib.h>

#include <errno.h>

#include <string.h>

#include <sys/types.h>

#include <netinet/in.h>

#include <sys/socket.h>

#include <sys/wait.h>

#define MYPORT 4950 /* the port users will be connecting to */

#define MAXBUFLEN 100

main()

{

int sockfd;

struct sockaddr_in my_addr; /* my address information */

struct sockaddr_in their_addr; /* connector's address information */

int addr_len, numbytes;

char buf[MAXBUFLEN];

if ((sockfd = socket(AF_INET, SOCK_DGRAM, 0)) == -1) {

perror("socket");

exit(1);

}

my_addr.sin_family = AF_INET; /* host byte order */

my_addr.sin_port = htons(MYPORT); /* short, network byte order */

my_addr.sin_addr.s_addr = INADDR_ANY; /* auto-fill with my IP */

bzero(&(my_addr.sin_zero), 8); /* zero the rest of the struct */

if (bind(sockfd, (struct sockaddr *)&my_addr, sizeof(struct sockaddr)) \

== -1) {

perror("bind");

exit(1);

}

addr_len = sizeof(struct sockaddr);

if ((numbytes=recvfrom(sockfd, buf, MAXBUFLEN, 0, \

(struct sockaddr *)&their_addr, &addr_len)) == -1) {

perror("recvfrom");

exit(1);

}

printf("got packet from %s\n",inet_ntoa(their_addr.sin_addr));

printf("packet is %d bytes long\n",numbytes);

buf[numbytes] = '\0';

printf("packet contains \"%s\"\n",buf);

close(sockfd);

}

결국 socket()를 호출할 때 SOCK_DGRAM을 사용하게 된것을 주의하고,

listen()이나 accept()를 사용하지 않은것도 주의해 봐야 한다.

이 코드가 바로 비연결 데이터그램 소켓의 자랑스러운 사용예인 것이다.

talker.c

#include <stdio.h>

#include <stdlib.h>

#include <errno.h>

#include <string.h>

#include <sys/types.h>

#include <netinet/in.h>

#include <netdb.h>

#include <sys/socket.h>

#include <sys/wait.h>

#define MYPORT 4950 /* the port users will be connecting to */

int main(int argc, char *argv[])

{

int sockfd;

struct sockaddr_in their_addr; /* connector's address information */

struct hostent *he;

int numbytes;

if (argc != 3) {

fprintf(stderr,"usage: talker hostname message\n");

exit(1);

}

if ((he=gethostbyname(argv[1])) == NULL) { /* get the host info */

herror("gethostbyname");

exit(1);

}

if ((sockfd = socket(AF_INET, SOCK_DGRAM, 0)) == -1) {

perror("socket");

exit(1);

}

their_addr.sin_family = AF_INET; /* host byte order */

their_addr.sin_port = htons(MYPORT); /* short, network byte order */

their_addr.sin_addr = *((struct in_addr *)he->h_addr);

bzero(&(their_addr.sin_zero), 8); /* zero the rest of the struct */

if ((numbytes=sendto(sockfd, argv[2], strlen(argv[2]), 0, \

(struct sockaddr *)&their_addr, sizeof(struct sockaddr))) == -1) {

perror("sendto");

exit(1);

}

printf("sent %d bytes to %s\n",numbytes,inet_ntoa(their_addr.sin_addr));

close(sockfd);

return 0;

}

이것이 다다. listener를 한 호스트에서 실행 시키고 다른 곳에서 talker를

실행시킨다. 핵가족시대에 어울리는 가족용 오락이 될수도...

앞에서도 얘기했었지만 한가지 작은 내용을 더 말해야 할것 같다.

만약 talker에서 connect()를 호출해서 연결을 했다면 그 다음부터는 sendto(),

recvfrom()이 아니라 그냥 send().recv()를 사용해도 된다는 것이다.

전달되어야 하는 호스트의 주소는 connect()에 지정된 주소가 사용되게 된다.

--------------------------------------------------------------------------------

블로킹

블로킹. 아마 들어봤겠지. 그런데 도대체 그게 뭘까? 사실 "잠들다"의

기술용어에 불과한 것이다.

아마도 listener를 실행시키면서 눈치를 챘겠지만 그 프로그램은 그저 앉아서

데이터 패킷이 올때까지 기다리는 것이다. 잠자면서.. recvfrom()을 호출했는데

데이터가 들어온 것이 없다면? 바로 뭔가 데이터가 들어올 때까지 블로킹이 되는

것이다(그냥 거기서 자고 있는 것이다.).

많은 함수들이 블로킹이 된다. accept()는 블록이 된다. recv*()종류들이 모두

블록이 된다. 그들이 이렇게 할 수 있는 이유는 그렇게 할 수 있도록 허락을

받았기 때문이다. 처음에 socket()으로 소켓이 만들어질때 커널이 블록 가능하도록

세팅을 했기 때문이다. 만일 블록할수 없도록 세팅하려면 fcntl()을 사용한다.

#include <unistd.h>

#include <fcntl.h>

sockfd = socket(AF_INET, SOCK_STREAM, 0);

fcntl(sockfd, F_SETFL, O_NONBLOCK);

소켓을 블록할수 없도록 세팅함으로써 정보를 추출하는 데에 효과적으로

socket을 이용할 수 있다. 만일 데이터가 접수되지 않은 소켓에서 데이터를

읽으려고 시도한다면 -1을 결과로 돌려주고 errno를 EWOULDBLOCK 으로 세팅하게

된다.

일반적으로는 이런 식으로 정보를 뽑아 내는 것은 별로 좋은 방식은 아니다.

만일 들어오는 데이터를 감시하기 위하여 이런 방식으로 바쁘게 데이터를 찾는

루틴을 만든다면 이는 CPU 시간을 소모하게 되는 것이다. 구식이다. 보다 멋진

방법은 다음절에 나오는 select()를 사용하여 데이터를 기다리는 식이다.

--------------------------------------------------------------------------------

select() ; 동기화된 중복 입출력. 대단하군!

이건 뭔가 좀 이상한 함수이다. 그러나 상당히 유용하므로 잘 읽어보기 바란다.

다음 상황을 가정해 보자. 지금 서버를 돌리고 있으며 이미 연결된 소켓에서

데이터가 들어오는 것을 기다리고 있다고 하자.

문제없지, 그냥 accept()하고 recv()몇개면 될텐데.. 서둘지 말지어다,

친구. 만일 accept()에서 블로킹이 된다면? 동시에 어떻게 recv()를 쓸 것인가?

블로킹 못하게 세팅한다고? CPU시간을 낭비하지 말라니까. 그러면 어떻게?

더이상 떠들지 말고 다음을 보여주겠다.

#include <sys/time.h>

#include <sys/types.h>

#include <unistd.h>

int select(int numfds, fd_set *readfds, fd_set *writefds,

fd_set *exceptfds, struct timeval *timeout);

이 함수는 화일 기술자의 "집합", 특별히 readfds,writefds,exceptfds등을

관리한다. 만일 일반적인 입력이나 소켓 기술자로부터 읽어 들일수 있는가를

확인하려면 단지 화일 기술자 0과 sockfd를 readfds에 더해주기만 하면 된다.

numfds는 가장 높은 파일 기술자에다가 1을 더해서 지정해야 하며 이번 예제에서

는 정규 입력의 0보다 확실히 크게 하기 위해서 sockfd+1 을 지정해야 한다.

select()의 결과값이 나올때 readfs는 선택한 파일 기술자 중에 어떤 것이 읽기

가능한가를 반영할 수 있도록 수정되며 FD_ISSET() 매크로를 이용하여 체크할 수

있다.

너무 멀리 나가기 전에 이 "집합"들을 어떻게 관리하는 가에 대해서 얘기를 해야

할것 같다. 각각의 "집합"은 fd_set형이며 다음의 매크로들로 이를 제어할 수

있다.

FD_ZERO(fd_set *set) - 파일기술자 집합을 소거한다.

FD_SET(int fd, fd_set *set) - fd 를 set에 더해준다.

FD_CLR(int fd, fd_set *set) - fd 를 set에서 빼준다.

FD_ISSET(int fd, fd_set *set) - fd가 set안에 있는지 확인한다.

끝으로 이 수상한 struct timeval은 또 무엇인가? 아마도 누군가가 어떤 데이터를

보내는 것을 무한정 기다리기를 원치는 않을 것이다. 특정시간마다 아무일도 안

벌어지더라도 "현재 진행중..."이라는 메시지를 터미널에 출력시키기라도 원할

것이다. 이 구조체는 그 시간간격을 정의하기 위해서 사용되는 것이다. 이

시간이 초과되고 그 때까지 select()가 아무런 변화를 감지하지 못한 경우라면

결과를 돌려주고 다음 작업을 진행 할수 있도록 해준다.

struct timeval의 구조는 다음과 같다.

struct timeval {

int tv_sec; /* seconds */

int tv_usec; /* microseconds */

};

기다릴 시간의 초를 지정하려면 그냥 tv_sec에 지정하면 된다.

tv_usec에는 마이크로 초를 지정한다. 밀리초가 아니고 마이크로초이다.

마이크로초는 백만분의 일초이다. 그런데 왜 usec인가? u는 그리스 문자의

Mu를 닮았고 이는 마이크로를 의미하는데 사용된다. 함수가 끝날때 timeout에

남은 시간이 기록될수도 있으며 이 내용은 유닉스마다 다르기는 하다.

와우~ 마이크로 초 단위의 타이머를 가지게 되었군! 만일 timeval에 필드들을

0으로 채우면 select()는 즉시 결과를 돌려주며 현재 set들의 내용을 즉시

알려주게 된다. timeout을 NULL로 세팅하면 결코 끝나지 않고 계속 파일

기술자가 준비되는 것을 기다리게 되며 끝으로 특정한 set에 변화에 관심이

없다면 그 항목을 NULL로 지정하면 된다.

다음은 정규 입력에 무언가 나타날때까지 2.5초를 기다리는 코드이다.

#include <sys/time.h>

#include <sys/types.h>

#include <unistd.h>

#define STDIN 0 /* file descriptor for standard input */

main()

{

struct timeval tv;

fd_set readfds;

tv.tv_sec = 2;

tv.tv_usec = 500000;

FD_ZERO(&readfds);

FD_SET(STDIN, &readfds);

/* don't care about writefds and exceptfds: */

select(STDIN+1, &readfds, NULL, NULL, &tv);

if (FD_ISSET(STDIN, &readfds))

printf("A key was pressed!\n");

else

printf("Timed out.\n");

}

만일 한줄씩 버퍼링하는 터미널이라면 엔터키를 치지 않는 이상은 그냥

타임아웃에 걸릴것이다.

이제 아마도 이 훌륭한 방법을 데이터그램 소켓에서 데이터를 기다리는 데에

사용할수 있으리라고 생각할 것이다. 맞다. 그럴 수도 있다. 어떤 유닉스에서는

이 방법이 되지만 안되는 것도 있다. 하고자 하는 내용에 대해서는 아마도

맨페이지를 참조해야 할 것이다.

select()에 관한 마지막 얘기는 listen()이 된 소켓이 있다면 이 방법을

이용하여 소켓 기술자를 readfds에 첨가하는 방식으로 새로운 연결이 있었는가를

확인할 수도 있다는 것이다.

이것이 select()에 대한 짧은 검토였다.

참고사항

여기까지 와서는 아마 좀더 새로운 다른 것은 없는가 할것이다.

또 어디서 다른 무언가를 더 찾을수 있는가를 알고자 할것이다.

초보자라면 다음의 맨페이지를 참고하는 것도 좋다.

socket()

bind()

connect()

listen()

accept()

send()

recv()

sendto()

recvfrom()

close()

shutdown()

getpeername()

getsockname()

gethostbyname()

gethostbyaddr()

getprotobyname()

fcntl()

select()

perror()

다음 책들도 도움이 될것이다. books:

Internetworking with TCP/IP, volumes I-III

by Douglas E. Comer and David L. Stevens.

Published by Prentice Hall.

Second edition ISBNs: 0-13-468505-9, 0-13-472242-6, 0-13-474222-2.

There is a third edition of this set which covers IPv6 and IP over ATM.

Using C on the UNIX System

by David A. Curry.

Published by O'Reilly & Associates, Inc.

ISBN 0-937175-23-4.

TCP/IP Network Administration

by Craig Hunt.

Published by O'Reilly & Associates, Inc.

ISBN 0-937175-82-X.

TCP/IP Illustrated, volumes 1-3

by W. Richard Stevens and Gary R. Wright.

Published by Addison Wesley.

ISBNs: 0-201-63346-9, 0-201-63354-X, 0-201-63495-3.

Unix Network Programming

by W. Richard Stevens.

Published by Prentice Hall.

ISBN 0-13-949876-1.

웹상에는 다음과 같은 것들이 있을것이다.

BSD Sockets: A Quick And Dirty Primer (http://www.cs.umn.edu/~bentlema/unix/--has other great Unix system programming info, too!)

Client-Server Computing (http://pandonia.canberra.edu.au/ClientServer/socket.html)

Intro to TCP/IP (gopher) (gopher://gopher-chem.ucdavis.edu/11/Index/Internet_aw/Intro_the_Internet/intro.to.ip/)

Internet Protocol Frequently Asked Questions (France) (http://web.cnam.fr/Network/TCP-IP/)

The Unix Socket FAQ (http://www.ibrado.com/sock-faq/)

끔찍하지만..RFC도 봐야 하겠다.

RFC-768 -- The User Datagram Protocol (UDP) (ftp://nic.ddn.mil/rfc/rfc768.txt)

RFC-791 -- The Internet Protocol (IP) (ftp://nic.ddn.mil/rfc/rfc791.txt)

RFC-793 -- The Transmission Control Protocol (TCP) (ftp://nic.ddn.mil/rfc/rfc793.txt)

RFC-854 -- The Telnet Protocol (ftp://nic.ddn.mil/rfc/rfc854.txt)

RFC-951 -- The Bootstrap Protocol (BOOTP) (ftp://nic.ddn.mil/rfc/rfc951.txt)

RFC-1350 -- The Trivial File Transfer Protocol (TFTP) (ftp://nic.ddn.mil/rfc/rfc1350.txt)

--------------------------------------------------------------------------------

주의사항 및 연락처

이상이 전부이며 문서상에서 크게 틀린 곳이 없기만을 바랄 뿐이다.

하지만 실수는 항상 있는 법이다.

만약 실수가 있다면 부정확한 정보를 주어 헷갈리게 만듯것에 대하여 사과하지만

사실상 나한테 책임을 물을수는 없다. 이 얘기는 법적인 경고이며 사실상 이 모든

글들이 몽땅 거짓말 일수도 있는 것이다.

그래도 설마 그렇지는 않을 것이다. 사실 난 이 모든것들 때문에 상당히 많은

시간을 소모했고 윈도우용 TCP/IP네트워크 유틸리티(예를 들어 텔넷등)을

방학숙제로 했었다. 난 소켓의 신이 아니라 그냥 보통 사람일 뿐이다.

그건 그렇고 생산적인 (혹은 파괴적이라도) 비평이 있는 분은

beej@ecst.csuchico.edu 앞으로 메일을 주기 바란다. 참고하여 고쳐나가도록

노력을 해 보겠다.

왜 이 일을 했는가 궁금하다면, 돈벌려고 했다. 하하~ 사실은 아니고 많은

사람들이 소켓에 관련된 질문을 해 대는 바람에 그들에게 이 내용을 웹에

올리려고 생각중이라고 말했더니 "바로 그거야~"라고들 해서 썼다.

아무리 고생해서 얻은 정보라도 만일 다른 사람과 공유하지 않는다면 쓰레기일

뿐이라고 생각한다. WWW는 바로 적당한 수단이 된 것 뿐이다. 다른 사람도 이런

정보의 제공이 가능하다면 이렇게 해주길 바란다.

끝났다. 프로그램이나 짜러가자. ;-)

번역한 사람의 말: 우연히 이 글을 발견하게 되어 번역을 하고 보니 나름대로

가치가 있어 보여서 홈페이지에 올려 놓았습니다. 번역상의 실수가 있었다면

사과드리며 지적해 주신다면 고쳐 나가겠습니다. 좋은 프로그램을 만드는데에 이

글이 작으나마 도움이 되길 바랍니다.

--------------------------------------------------------------------------------

This guide may be reprinted in any medium provided that its content is not

altered, it is presented in its entirety, and this copyright notice remains

intact. Contact beej@ecst.csuchico.edu for more information.

좋은 내용의 글을작성하고 한글판 번역을 허락해준 원작자에게 감사하며

번역자로서의 모든권리는 읽어주신 분들께 드리겠습니다. 번역상의 실수나

생산적인 지적은 tempter@fourthline.com 으로 보내주시면 되겠습니다.

감사합니다.

IOCP를 사용한 머그게임 서버만들기

래머 — Sat, 2 Jun 2018 07:34:47 +0900

십년전 공부할때 참고한자료입니다. 제가 쓴글이 아닙니다.

IOCP를 사용한 머그게임 서버만들기

1. 프로토콜이란?

프로토콜이란 한 컴퓨터와 다른 컴퓨터가 통신하는 방식을 정의한 것이다. 즉, 원거리에 있는 두 사람이 서로 교신을 할 때, 빨간 깃발을 들으면 누군가 공격해온다는 의미이고, 파란색 깃발을 들면 비가 온다는 의미라고 정하는 것 이것이 프로토콜이다.

일반적으로 머그게임 또는 대부분의 인터넷을 경유하는 통신에서 프로토콜을 만들 때 TCP/IP 기반에서 프로토콜을 작성한다고 한다. 이는 TCP/IP의 프로토콜을 사용하여 자신만의 프로토콜을 만드는 것을 의미한다. 어쨌든 프로토콜에 대한 자세한 내용은 다른 서적을 참조하기 바란다. 여기서, 중요한 것은 네트워크를 통해서 컴퓨터끼리 통신을 하기 위해서는 프로토콜을 정의 해야 한다는 것만 알면 충분하다.

어떤 의미를 가진 것을 이제부터 패킷이라고 부르자. 즉 하나의 프로토콜을 여러 개의 패킷으로 이루어졌다. 누군가 공격을 해 올 때는 빨간 깃발을 들어라. 여기서 빨간 깃발이 패킷이 되는 것이다.

이제 머그게임에서 나올만한 상황 중에 하나인 이동에 대한 패킷을 만들어보자. 이동 패킷이 어떤 정보를 가지고 있을 것인가는 프로그래머의 마음이다. 필자는 이 패킷이 어떤 패킷인지에 대한 정보( Command )와 이동위치(X, Y)의 정보를 가지는 패킷을 만들도록 하겠다.

BYTE[4] Command

BYTE[4] X 좌표

BYTE[4] Y 좌표

위와 같이 이동 패킷이 만들어졌다. 각각의 정보가 4바이트로 이루어진 12바이트의 패킷이 만들어졌다. 이와 같이 머그게임의 서버와 클라이언트가 서로 전달해야 할 모든 메시지에 대해 패킷을 만드는 것이 프로토콜 작성이다.

한가지 더 알아야 하는 것은 네트워크에서는 실제로 자신이 원하는 만큼 쓰고 원하는 만큼 읽을 수 없다는 것이다.

send( socket, packet, size, 0 );

recv( socket, packet, size, 0 );

다음과 같은 두 코드를 보고 프로그래머는 항상 packet버퍼에 있는 내용을 size만큼 쓰고 읽을 수 있다고 생각하면 안 된다. 이는 네트워크 상에서 발생하는 여러 가지 문제에 의해서 얼마를 읽고 쓸 수 있는지 결정이 된다.( 자세한 내용은 관련서적 참조 ) 따라서, 프로그래머는 항상 원하는 만큼의 데이터를 읽고 썼는지에 대해 확인을 해야 한다. 어떻게 원하는 만큼의 데이터를 읽고 쓸 수 있는지는 뒤에서 설명하겠다.

위와 같은 이유 때문에 우리가 만드는 패킷에는 길이에 대한 정보가 추가 되어야 한다. 즉, 위에서 만든 이동 패킷은 다음과 같이 변경되어야 한다.

BYTE[2] 패킷의 길이

BYTE[4] Command

BYTE[4] X 좌표

BYTE[4] Y 좌표

2바이트의 패킷 길이가 추가 되었다. 필자는 패킷이 아무리 길어도 65535바이트를 넘지 않을 것이라고 생각해서 패킷의 길이를 2바이트로 나타내었다. 그러나 자신은 4바이트 또는 1바이트로 만들겠다고 한다면 그렇게 해도 상관없다.

이제 다음에서는 위와 같이 만든 패킷들을 어떻게 쓰고 읽는 지에 대해서 알아보도록 하겠다.

2. 패킷 쓰기와 읽기

먼저, 패킷을 쓰는 것에 대해서 알아보도록 하자. 사실 쓰는 것에 대해서는 별로 걱정할 것이 없다.

send( socket, packet, size, 0 );

위와 같이 우리가 아는 방식대로 쓰기만 하면 된다. 단 “IOCP사용하기”나 “IOCP로 채팅만들기”에서 말했던 것과 같이 중첩입출력의 경우 packet의 내용은 작업이 끝나기 전에는 변경되면 안 된다는 사실만 기억하기 바란다.

패킷을 읽는 것은 쓰는 것과는 다르게 약간의 처리를 해주어야 하는데 이는 1장에서 패킷에 패킷 길이를 추가한 이유이기도 하다.

int nRead;

while ((nRead = recv(hSocket, g_szPacket, PACKET_BUFFER - g_nPI, 0)) > 0)

{

g_nRI += nRead;

while (g_nPI < g_nRI)

{

if (g_mode == PACKET_LENGTH)

{

if (g_nPI + 2 <= g_nRI)

{

g_sPacketLen = g_szPacket[0] + (g_szPacket[1] << 8) - 2;

g_nPI += 2;

g_mode = PACKET_BODY;

}

else

break;

}

else if (g_mode == PACKET_BODY)

{

if (g_nPI + g_sPacketLen <= g_nRI)

{

if (g_szPacket[g_nPI] >= S_MAX)

{

}

else

{

Packet(g_szPacket + g_nPI);

}

g_nPI += g_sPacketLen;

g_mode = PACKET_LENGTH;

}

if( g_nPI == g_nRI )

{

g_nPI = g_nRI = 0;

}

else if (g_nPI > 0)

{

memmove(g_szPacket, g_szPacket + g_nPI, g_nRI - g_nPI);

g_nRI -= g_nPI;

}

표 1 프로그램세계 12월호 특집기사중 (TCP/IP기반의 멀티플레이어 온라인 게임제작 관련화일에서 발취) ( 이에 대한 설명은 프로그램세계 12월호에 있을거라고 생각합니다. 이해 안되시면 질문 주세요 )

위의 소스는 하나의 패킷을 정확히 읽을 수 있는 가장 좋은 방법이라고 생각하는 소스이다. 우리가 만들 머그 서버에서도 위와 같은 알고리즘으로 패킷을 읽어 오도록 하겠다.

3. 이 모든 것을 종합하여 머그게임 서버를 작성하자.

먼저 우리가 머그게임 서버를 만들기 위해서 필요한 것들을 생각해보도록 하자.

l ICOP 핸들

“IOCP채팅서버만들기” 참조

l 확장 OVERLAPPED구조체 또는 클래스

“IOCP채팅서버만들기” 참조

l 클라이언트 정보를 저장할 공간

“ICOP채팅서버만들기”에서는 클라이언트의 소켓만을 저장했지만, 패킷 읽기를 구현해야 하기 때문에 많은 정보가 필요하다.

Class CClient

{

public:

enum { PACKET_BODY, PACKET_LENGTH };

enum { PACKET_BUFFER = 512 };

SOCKET m_Socket;

int m_nPI;

int m_nRI;

short m_nPacketLen;

};

Ccleint g_ClientC[MAX_CLIENT];

지금은 서버를 구성하는 것이 중심이므로 클래스를 다음과 같이 만들지만, 위와 같이 GetXXX(), SetXXX()로 만들어지는 클래스는 프로그래머가 잘못 클래스를 작성했다고 생각하면 틀림없다.

4. 채팅서버 프로그램을 확장하자

// IOCP.cpp

#define WIN32_LEAN_AND_MEAN // Exclude rarely-used stuff from Windows headers

#include <windows.h>

#include <winsock2.h>

#include <stdio.h>

#define MY_RECV_BUFFER 512

//#define MY_CHAT_PORT 50000

#define MY_MAX_CLIENT 10

#define MY_MAX_PACKET 100

class CClient

{

public:

enum MODE { PACKET_BODY, PACKET_LENGTH };

SOCKET m_Socket;

int m_nPI;

int m_nRI;

short m_nPacketLen;

MODE m_eMode;

public:

CClient()

{

m_Socket = INVALID_SOCKET;

m_nPI = m_nRI = 0;

m_nPacketLen = 0;

m_eMode = PACKET_BODY;

}

};

#define READ 1

#define WRITE 2

class CXOverlapped : public OVERLAPPED

{

public:

int mode; // Read냐 Write냐..결정.

char szRecv[MY_RECV_BUFFER];

int iNum; // Send할 때, 같은 데이터를 여러 개 만들지

// 않기 위해서 사용하는 변수이다.

// 원리는 이 구조체를 사용하여 Send를 하면

// iNum값을 1씩 증가 시킨다. 작업 완료 처리

// 루틴에서 Send가 완료 되었으면 이 값을 1씩

// 빼주고 0이 된 구조체를 delete한다.

CXOverlapped()

{

Clear();

mode = READ;

}

~CXOverlapped()

{

}

inline void Clear()

{

Internal = 0;

InternalHigh = 0;

Offset = 0;

OffsetHigh = 0;

hEvent = 0;

}

};

SOCKET g_sockListen; //클라이언트의 접속을 대기하는 소켓

int g_nClients = 0; //현재 몇명의 클라이언트가 접속했는지 저장.

CClient g_ClientsC[MY_MAX_CLIENT];

HANDLE g_hCompletionPort;

// 소켓 초기화 함수.

BOOL InitSocket()

{

WORD wVer;

WSADATA wsaData;

SOCKADDR_IN serv_addr;

wVer = MAKEWORD(1,1);

if(WSAStartup(wVer, &wsaData) != 0)

{

printf( "WSAStartup() 실패 : %d\n", WSAGetLastError());

return FALSE;

}

g_sockListen = socket(AF_INET, SOCK_STREAM, 0);

if ( g_sockListen == INVALID_SOCKET )

{

printf( "socket() 실패 : %d\n", WSAGetLastError());

return FALSE;

}

ZeroMemory (&serv_addr, sizeof (serv_addr));

serv_addr.sin_family = AF_INET;

serv_addr.sin_port = htons(MY_CHAT_PORT);

if( bind( g_sockListen, (LPSOCKADDR)&serv_addr, sizeof(serv_addr) ) ==

SOCKET_ERROR )

{

printf( "bind() 실패 : %d\n", WSAGetLastError());

return FALSE;

}

if (listen(g_sockListen, 5) == SOCKET_ERROR)

{

printf( "listen() 실패 : %d\n", WSAGetLastError());

return FALSE;

}

printf("g_sockListen 소켓 초기화 성공\n");

return TRUE;

}

void PacketProcess( char* pPacket )

{

// 여기서 패킷에 대한 처리를 하며 된다.

}

DWORD WINAPI WorkerThread( void* pModel )

{

DWORD dwBytesTransferred;

DWORD dwCompKey;

CXOverlapped* pPacket;

LPOVERLAPPED pOverlap;

printf( "Worker 시작\n" );

while( 1 )

{

//////////////////////////////////////////

//3. Read Request from client

//////////////////////////////////////////

if( FALSE == GetQueuedCompletionStatus( g_hCompletionPort, &dwBytesTransferred,

&dwCompKey, (LPOVERLAPPED *)&pOverlap, INFINITE ) )

{

if( pOverlap != NULL )

{

printf( "Error Thread : GetQueueCompletionStatus( %d )\n",

GetLastError() );

return 0;

}

if( dwBytesTransferred == 0 )

{

printf("Closing socket %d\n", g_ClientsC[dwCompKey] );

if( SOCKET_ERROR == closesocket( g_ClientsC[dwCompKey].m_Socket ) )

{

if(GetLastError() == 10038)

{

continue;

}

else

{

printf("closesocket() failed with error %d\n", WSAGetLastError());

return 0;

}

continue;

}

//////////////////////////////////////////

//4. Excute request locally

//////////////////////////////////////////

pPacket = (CXOverlapped*)pOverlap;

if( READ == pPacket->mode )

{

g_ClientsC[dwCompKey].m_nRI += dwBytesTransferred;

while( g_ClientsC[dwCompKey].m_nPI < g_ClientsC[dwCompKey].m_nRI )

{

if( g_ClientsC[dwCompKey].m_eMode == CClient::PACKET_LENGTH )

{

if( g_ClientsC[dwCompKey].m_nPI + 2 <= g_ClientsC[dwCompKey].m_nRI)

{

g_ClientsC[dwCompKey].m_nPacketLen = pPacket->szRecv[g_ClientsC[dwCompKey].m_nPI]

+ (pPacket->szRecv[g_ClientsC[dwCompKey].m_nPI+1] << 8 ) - 2;

g_ClientsC[dwCompKey].m_nPI += 2;

g_ClientsC[dwCompKey].m_eMode = CClient::PACKET_BODY;

}

else

break;

}

else if( g_ClientsC[dwCompKey].m_eMode == CClient::PACKET_BODY )

{

if( g_ClientsC[dwCompKey].m_nPI + g_ClientsC[dwCompKey].m_nPacketLen <= g_ClientsC[dwCompKey].m_nRI )

{

//////////////////////////////////////////

//5. Return result to client

//////////////////////////////////////////

PacketProcess( (char*)(pPacket->szRecv + g_ClientsC[dwCompKey].m_nPI) );

g_ClientsC[dwCompKey].m_nPI += g_ClientsC[dwCompKey].m_nPacketLen;

g_ClientsC[dwCompKey].m_eMode = CClient::PACKET_LENGTH;

}

if( g_ClientsC[dwCompKey].m_nPI == g_ClientsC[dwCompKey].m_nRI )

{

g_ClientsC[dwCompKey].m_nPI = g_ClientsC[dwCompKey].m_nRI = 0;

}

else if( g_ClientsC[dwCompKey].m_nPI > 0 )

{

memmove( pPacket->szRecv,

pPacket->szRecv + g_ClientsC[dwCompKey].m_nPI,

g_ClientsC[dwCompKey].m_nRI - g_ClientsC[dwCompKey].m_nPI );

g_ClientsC[dwCompKey].m_nRI -= g_ClientsC[dwCompKey].m_nPI;

}

pPacket->Clear();

if( FALSE == ReadFile( (HANDLE)g_ClientsC[dwCompKey].m_Socket,

pPacket->szRecv + g_ClientsC[dwCompKey].m_nRI,

MY_RECV_BUFFER - g_ClientsC[dwCompKey].m_nRI,

NULL,

pPacket ) )

{

if( GetLastError() != ERROR_IO_PENDING )

{

printf("WSARecv() failed with error %d\n", WSAGetLastError());

return 0;

}

else if( WRITE == pPacket->mode )

{

printf( "Send complete to %d packet(%d)\n", dwCompKey, pPacket->iNum );

if( --(pPacket->iNum) <= 0 )

delete pPacket;

}

else

printf( "Error\n" );

}//while(1)

}

int main()

{

// 모든 과정을 진행 하기 전에 해야 하는 일들.

InitSocket();

g_hCompletionPort = CreateIoCompletionPort( INVALID_HANDLE_VALUE, NULL, 0, 0 );

if( INVALID_HANDLE_VALUE == g_hCompletionPort )

{

printf( "IOCP create error..\n" );

return 0;

}

// 쓰레드 생성.

DWORD ThreadId;

HANDLE ThreadHandle;

ThreadHandle = CreateThread( NULL, 0, WorkerThread,

NULL, 0, &ThreadId );

if (!ThreadHandle)

{

fprintf (stdout, "Create Worker Thread Failed\n");

return FALSE;

}

CloseHandle (ThreadHandle);

while( 1 )

{

//////////////////////////////////////////

//1. Wait for client to connect

//////////////////////////////////////////

SOCKET sockTemp = accept( g_sockListen, NULL, NULL );

if( INVALID_SOCKET == sockTemp )

{

printf("연결된 소켓 에러\n");

return 0;

}

//////////////////////////////////////////

//2. Open communication channel for client

//////////////////////////////////////////

printf( "Socket number %d connected\n" , sockTemp );

g_ClientsC[g_nClients].m_Socket = sockTemp;

// 접속한 소켓(핸들)-클라이언트 소켓을 저장한 배열의 인덱스(KEY)의

// 쌍으로 IOCP에 등록한다.

if( NULL == ( g_hCompletionPort = CreateIoCompletionPort(

(HANDLE)sockTemp ,

g_hCompletionPort,

(DWORD)g_nClients, 0 ) ) )

{

printf("CreateIoCompletionPort failed with error %d\n", GetLastError());

return 0;

}

CXOverlapped *pPacket = new CXOverlapped;

if( FALSE == ReadFile( (HANDLE)g_ClientsC[g_nClients].m_Socket,

pPacket->szRecv,

MY_RECV_BUFFER, NULL, pPacket ) )

{

if( GetLastError() != ERROR_IO_PENDING ) {

printf("ReadFile() failed with error %d\n", WSAGetLastError());

return 0;

}

g_nClients++;

}

return 0;

}

위에 소스에서 ProcessPacket() 함수는 표1의 소스 출처 프로그램에서 Packet()이라는 함수를 그대로 사용하시면 됩니다. 이 강좌는 전체 머그게임 서버를 구성하는 것이 아니라. IOCP를 사용하여 네트워크에서 패킷을 읽어 드리는 방법에 대해 초점을 잡았으므로 나머지는 표1의 출처자료를 참조하세요. 저보다 훨씬 설명이 잘되어있으니까요. 그럼, 모두들 열심히 프로그래밍 하시고요. 화이링~~~~

IOCP 사용 방법

래머 — Sat, 2 Jun 2018 07:33:14 +0900

IOCP 사용 방법

IOCP의 목적

IOCP는 프로그램이 어떤 핸들( 파일, 소켓 등 )에 대해 I/O 작업을 할 때, 블록 되지 않게 함으로써 프로그램의 대기 시간을 줄일 수 있는 방법이다.

블록이 되면 생기는 문제 제시하면서, 타당성 제공.

IOCP의 사용하기 위한 절차.

마치 IOCP에게 작업을 해줘라고 신청하고 신청한 작업이 끝나면 이런 작업을 누군가 하라고 했는데 그 작업이 지금 완료 되었다고 알려주는 것과 같은 절차를 가진다.

1. IOCP 핸들을 생성한다.

2. 핸들과 키의 쌍으로 IOCP핸들에 등록을 한다.

3. 핸들에 I/O 작업을 한다.( I/O작업을 신청한다는 의미가 더 어울릴 것 같다. )

4. 어떤 핸들에 대한 I/O작업이 완료되면 IOCP가 프로그램에게 알려준다.

5. 완료된 작업에 대해 해야 할 일을 한다.

1. IOCP 핸들을 생성한다.

I/O작업을 대신 해줄 IOCP 핸들을 생성해야 한다.

다음은 IOCP 핸들을 생성하기 위한 함수의 원형이다. 뒤에 보겠지만, 핸들과 키의 쌍을 IOCP 핸들에 등록하는 것도 이 함수를 사용한다.

HANDLE CreateIoCompletionPort (
HANDLE FileHandle, // handle to file
HANDLE ExistingCompletionPort, // handle to I/O completion port
ULONG_PTR CompletionKey, // completion key
DWORD NumberOfConcurrentThreads // number of threads to execute concurrently);

인자를 보면, hFile은 IOCP에 등록하는 I/O 핸들( 소켓, 파일 등 )이다. 이렇게 함으로써 IOCP는 hFile에서 일어나는 I/O를 감시하면서 작업이 끝났을 때, 알려줄 수 있게 되는 것 이다. 다음의 hExistingPort는 새로운 포트를 생성하려면 NULL, 기존에 있는 IOCP에 연결을 하려면 CreateIoCompletionPort()함수가 이전에 반환했던 IOCP 핸들을 넘겨준다. 세 번째 CompletionKey는 위에서 말했던 키를 나타낸다. 나중에 핸들에서의 작업이 끝나면 IOCP는 어떤 핸들에서의 작업인지 알려줄 때 핸들 값 자체를 넘겨주는 것이 아니라, 이 키 값을 알려준다. 따라서, 여러 개의 핸들을 등록했다면, 등록할 때 이 키 값을 고유하게 해주므로써 각각을 구분할 수 있도록 한다. 마지막 NumberOfConcurrentThreads는 IOCP가 입출력 작업을 할 때 얼마나 많은 쓰레드를 사용하여 작업을 할 지 설정하는 것으로 특별히 정확하게 얼마나 설정해야 할 지 모를 때는 0의 값으로 설정하면 가장 최적화된 방법으로 스레드를 생성하여 사용한다. 생성이 성공하면 IOCP핸들을 반환하고 실패 하면 NULL값을 반환한다.

Tip dwCompletionKey값은 여러 가지로 사용할 수 있다. 타입이 DWORD이므로 어떤 형식의 포인터로 사용하는 것도 가능하고 정수로써도 사용할 수 있다.

HANDLE hIOCP;

hIOCP = ::CreateIoCompletionPort( INVALID_HANDLE_VALUE, NULL, NULL, NULL );

그저 생성하는 것이므로 다음과 같이 생성을 한다.

2. 핸들과 키의 쌍으로 IOCP핸들에 등록을 한다.

위에서 설명한 CreateIoCompletionPort함수를 사용하여 핸들과 키를 등록할 수 있다.

HANDLE hFileHandle; //IOCP에 등록하고 싶은 핸들.

m_hIOCP = ::CreateIoCompletionPort(

hFileHandle,

hIOCP,

dwCompkey,

NumberOfCurrentThread );

이와 같이 hFileHandle-dwCompkey 쌍으로 등록하면 나중에 I/O출력함수를 hFileHandle을 인자로 호출을 하면 I/O가 끝나면 IOCP가 dwCompkey값을 주면서 I/O작업이 끝났다고 알려준다. 그러므로 dwCompkey값을 어떤 값으로 사용하냐에 따라 프로그램을 작성하는 방법이 많이 달라질 수 있다.

IOCP의 기법은 어떤 핸들( 파일, 소켓 등등 )과 특정 값을 일치 시켜서 나중에 작업을 알수 있도록 하는 것이다.

사용자는 어떤 핸들에 대한 작업이 완료 되었을 때, 어떤 값을 알려달라고 시스템에 알려준다.

그리고, 핸들에 I/O작업을 실시한다. 다른 작업을 하는 도중 핸들에 I/O작업이 완료 되었으면 시스템은 프로그램에게 처음에 등록했던 값을 알려준다.

3. 핸들에 I/O 작업을 한다.

윈도우에서는 소켓이나 파일 핸들이나 같이 사용되기 때문에 아무 I/O함수나 사용하여 I/O작업을 신청한다.

단 여기서 중요한 것은 IOCP는 중첩된(Overlapped) I/O 방식을 사용한다는 것이다. 따라서, WSARecv()/WSASend(), ReadFile()/WriteFile()을 사용할 것을 권장한다.

OVERLAPPED *pPacket = new OVERLAPPED;

if( FALSE == ReadFile( (HANDLE)hFileHandle,

szBuffer,

MAX_BUFFER,

NULL,

pPacket ) )

{

if( GetLastError() != ERROR_IO_PENDING )

{

printf("ReadFile() failed with error %d\n", GetLastError());

return 0;

}

위와 같이 프로그램을 작성하여 입출력을 등록한다. 보통 우리가 알고 있는 것과 차이가 있다면 OVERLAPPED 구조체를 생성하여 인자로 넘겨준다는 것이다. 이 구조체에 대한 자세한 정보는 전문서적을 참조하기 바란다. 하지만 이 구조체의 가장 큰 역할은 나중에 IOCP가 작업이 완료되었다고 알려줄 때, 읽기 작업을 끝냈는지 쓰기 작업을 끝냈는지 또는 10개의 작업을 하라고 했는데 도대체 어떤 작업을 끝냈는지 알려 줄 방법이 없으므로 이 구조체를 사용하여 작업을 신청하기 전에 나중에 끝났을 때 알아볼 수 있도록 흔적을 남기기 위한 것이다. ( 원래는 더 많은 의미를 담고 있지만, 잘 사용 안 하니까… ) 따라서, OVERLAPPED 구조체를 상속하여 흔적에 사용할 정보를 담을 수 있도록 만들어서 사용한다.

4. 어떤 핸들에 대한 I/O작업이 완료되면 IOCP가 프로그램에게 알려준다.

IOCP가 작업의 완료를 알려주는 것을 받는 방법은 여러 가지가 있으나 여기서는 GetQueuedCompletionStatus() 함수를 사용하는 법을 알아보도록 한다.

BOOL GetQueuedCompletionStatus(

HANDLE CompletionPort, // handle to completion port

LPDWORD lpNumberOfBytes, // bytes transferred

PULONG_PTR lpCompletionKey, // file completion key

LPOVERLAPPED *lpOverlapped, // buffer

DWORD dwMilliseconds // optional timeout value

);

첫 번째 CompletionPort는 이전에 생성했던 IOCP 핸들이고, lpNumberOfBytes I/O작업에서 읽거나 쓴 바이트의 수를 반환해 준다. 세 번째 인자는 핸들을 IOCP에 등록할 때 키로 등록했던 값을 반환해준다. 이 값을 가지고 어떤 핸들로 부터의 작업이 완료가 되었는지 알수 있다. 네 번째 인자는 작업을 등록할 때, 어떤 작업인지 흔적으로 남겼던 OVERLAPPED 구조체를 반환해 준다. 이 구조체에 남겨진 정보를 가지고 어떤 작업이 끝난건지 알 수 있도록 수동으로 만들어야 한다. 여섯 번째 인자는 IOCP로부터 오는 완료 메시지를 얼마나 대기 하고 있을 것인지 설정하는 값이다.

if( FALSE == GetQueuedCompletionStatus(

hIOCP,

&dwBytesTransferred,

&dwCompKey,

(LPOVERLAPPED *)&pOverlap,

INFINITE ) )

{

if( pOverlap != NULL )

{

if( 64 != GetLastError() )

{

printf( "Error Thread : GetQueueCompletionStatus( %d )\n", GetLastError() );

return 0;

}

위와 같이 사용한다. 주의 해야 할 것은 GetQueuedCompletionStatus함수가 반환하는 값이 FALSE라고 해서 에러가 아니라 pOverlap이 NULL이고 FALSE를 발생했던 에러의 값이 64가 아닐 때만 진짜로 에러가 발생한 것이라는 것이다.

5. 완료된 작업에 대해 해야 할 일을 한다.

위에 GetQueuedCompletionStatus함수에서 전달 받은 값들을 가지고 3번 과정에서 I/O작업을 신청할 때, I/O작업이 끝나면 하려고 했던 작업을 하면된다.

if( dwBytesTransferred == 0 )

{

printf("Closing socket %d\n", g_CClients[dwCompKey].GetSocket() );

if( SOCKET_ERROR == closesocket( g_CClients[dwCompKey].GetSocket() ) )

{

if(GetLastError() == 10038)

continue;

else

{

printf("closesocket() failed with error %d\n", WSAGetLastError());

return 0;

}

continue;

}

//recv

if( /* pOverlap에 읽기 작업이라는 흔적이 있다면 */ )

{

// 또 하나 중요한 것은 3번에서 신청한 I/O작업에 사용한 버퍼의 포인터를

// 여기서 알고있어야 한다는 것이다.

Printf( “%s\n”, szBuffer );

}

else if( /* pOverlap에 쓰기 작업이라는 흔적이 있다면 */ )

{

printf( “쓰기가 완료되었네요…\n” );

}

else

{

// 남겼던 흔적이 없거나 에러가 발생한것임.

}

위의 GetQueuedCompletionStatus함수에서 반환해준 dwBytesTransferred의 값이 0이란 의미는 해당 핸들이 끊어졌다는 것이다. ( 소켓의 경우 ) 따라서, 핸들을 닫아 주면 된다. 그 다음에는 아까 전에 말했던 OVERLAPPED구조체에 3번에서 I/O작업 신청할 때 남겼던 흔적에 따라서 나머지를 처리해 주면 된다.

IOCP를 사용할 때 주의 할 점

IOCP 기법을 사용할 때의 주의 할 점은 I/O작업에 사용할 버퍼가 I/O작업을 신청한 시점부터 IOCP로부터 완료했다는 메시지를 받기 전까지 변경이 되면 안 된다는 것이다. 따라서, I/O 작업에 사용하는 버퍼는 전역 변수이거나 동적으로 할당된 메모리 공간이어야 한다. 특히 WSASend()나 WriteFile() 작업을 할 때, 함수를 호출하는 시점에 사용했던 공간을 함수이 끝나자 마자 지워버리거나( 지역 변수 ), 다른 값으로 변경하게 되면, 나중에 IOCP가 시간이 생겨서 이 작업을 할 때, 엉뚱한 공간을 참조하거나, 원래 쓰려고 했던 데이터가 아닌 다른 데이터를 쓰게 되므로 조심해야 한다.

OVERLAPPED구조체도 마찬가지다. 작업이 끝나기 전에 지워지면 안 된다.

16비트 컬러의 이펙트 필터 소개와 그 알고리즘

래머 — Sat, 2 Jun 2018 07:19:32 +0900

--------------------------------------------

16비트 컬러의 이펙트 필터 소개와 그 알고리즘

--------------------------------------------

전석환 (INGRAM)

요즘 16비트 게임이 러쉬합니다. 16비트의 구조적/운용적 난점에도 불구하고 많은

개발사들이 16비트를 선택하는데는 나름대로 이유가 있습니다. 그 어쩔 수 없는

이유중에 하나인 "16비트 모드만이 누릴수 있는 이펙트-Alpha Blend, 광원효과-"

에 대해 완벽 분석을 해보겠습니다.

아래에 부연되는 모든 연산작업은 각각 RGB별 배열로 작성하여 구현되므로 속도상

에 커다란 영향을 주지 않습니다. 참고로 하나의 효과를 구현 하기에 소요되는 배

열의 크기는 배열1[32][32], 배열2[64][64]로 long 형 선언시 20 K byte입니다.

약간의 소스도 준비되어 있으니 개념을 이해하시기 어렵지 않을겁니다.

1. Color Dodge

응용분야 : 빛 계열(전격계 포함)의 효과 및 마법에 가장 적합한 효과입니다.

알고리즘 : 표현되는 결과물(Dodge)을 위해 필요한 자재를 바탕색(BG)과 덧색

(SPR)으로 나누었을때 RGB별 공통되는 연산식은 ...

Dodge=(BG*MAXDAC)/(MAXDAC-SPR)

입니다. 이는 바탕색의 DAC가 높으면 높을수록 Dodge 본연의 색상

이 나와주는 것이며 또한 반대로 바탕색이 어두우면 어두울수록 D

odge 효과가 약해진다는 것을 살펴볼 수 있습니다. 또한 Dodge 로

강렬한 표현을 하려면 배경과 마찬가지로 SPR 의 전체적인 밝기가

높아야만 원래 추구하는 이미지를 전달하게 됩니다.

주의할점은 Dodge 의 표현상 원래 SPR의 섬세한 이미지 전달을 불

가능하다는 것입니다. ( SPR 이미지의 심한 왜곡 )

2. Lighten

응용분야 : SPRITE, 원래의 색상이 필요한 -색의 왜곡없는- 다중 투명 효과.

알고리즘 : 일단 알고리즘은 상당히 간단합니다. RGB 별로 BG, SPR 중 큰 DAC

값을 취하면 그 값이 바로 Lighten 을 구현하는 값이 됩니다.

Lighten = max ( BG, SPR )

이 Lighten 효과는 Table을 필요로 하지 않기 때문에 속도상에 약

간의 이점을 가지게 됩니다. 다른 효과들과는 달리 색상의 왜곡이

전혀 없으므로 원래 SPR 에 가장 근접한 이미지를 전달할 수가 있

다는 장점도 있습니다. 하지만 알고리즘상의 문제점으로 BG 의 밝

기에 따라 생략되는 부분도 있을 수 있어 실제 SPR 이미지의 크기

중 많은 부분이 축소/생략 되는 경향또한 있습니다.

3. Screen

응용분야 : 연기같이 부드럽고-Soft touch- 연한 소재의 효과로 적합합니다.

(굴뚝에서 피어나는 연기따위...)

알고리즘 : Lighten의 개량형이라 생각하면 됩니다. 연산식을 살펴보면 ...

TempSum=(MAXDAC-max(BG,SPR))/MAXDAC*min(BG,SPR)

Screen=max(BG,SPR)+TempSum

다시 말하면 Lighten은 자신(SPR)의 색상을 과장하지 않지만 Scr

een 은 어느정도 (어느정도라지만 일정한 왜곡률을 위한 계산식이

있다) 자신의 색상을 높여서 표현하기 때문에 원래 이미지의 축소

/생략되는 부분이 없어,실제 구현되는 이미지의 영역도 Lighten보

다 넓습니다.

4. Dodge-Screen

응용분야 : 불 계통의 모든 효과와 화염계 마법 모두.

알고리즘 : 불을 표현하는 Effect를 위해 Dodge와 Screen 을 보완하여 결합한

효과입니다. Dodge로 일단 BG 쪽의 색 왜곡을 심화하고 그뒤에 Do

dge 효과로 왜곡된 메인 이미지들을 Screen 방식을 이용해 밝은색

위주로 깨끗하게 정렬합니다. 쉽게 설명드리자면 Dodge 로 BG쪽을

끌어당긴 다음 Screen으로 한번 더 Effect 를 먹인것과 다를 바가

없습니다.(하지만 효과를 재차 반복할 수는 없는 관계로 Table 을

작성하여 단 한번에 구현합니다.)

5. Screen-Dodge

응용분야 : Dodge의 특성상 BG의 왜곡 심도를 결정함에 있어 BG가 제로에 가까

운 수 혹은 제로일때 왜곡이 불가능한 것을 보완한 필터 로써 완벽

히 검은색의 BG에서도 Dodge가 구현. (플레이 스테이션에서 사용되

는 Dodge 필터 구현과 동일 )

알고리즘 : 위 5번항과 마찬가지이나 구현 순서만 바뀌면 됩니다. 일단 Screen

효과로 BG를 끌어 올린다음 Dodge로 왜곡을 심화합니다.5번항이 구

현됐다면 아주 쉬운 CASE입니다.

6. Dodge-Burn

응용분야 : 불에 타 시커멓게 그을린 듯한 효과, 굴뚝 연기.

알고리즘 : Color Dodge 효과를 정 반대로 응용한 효과로 Dodge와는 달리 SPR

색상이 높을 수록 BG 색상을 어둡게 왜곡합니다. 반대로 SPR 색상

이 낮을 수록 BG 본연의 색상이 표현되게 왜곡을 약화합니다.

DodgeBurn = (BG*(MAXDAC-SPR))/MAXDAC;

색의 왜곡을 심화하려면 ( MAXDAC-SPR )과 (MAXDAC), 분자 분모부

를 제곱 연산합니다.( 경험으로 볼때 3제곱 연산이 적당하다 )

7. Different

응용분야 : 암흑 마법 발동이나 독, 마비등의 Effect 응용 가능.

알고리즘 : BG 와 SPR 색상의 편차를 고스란히 대입하는 간단한 알고리즘.

Different=(max(BG,SPR)-min(BG,SPR))

이를 이용하여 텍스쳐 형식으로 캐릭터에게 독립적인 표현이 가능

하므로 상태 이상시 캐릭터 Status 표현으로도 응용할 수 있습니다.

==========================================================================

(주1) 위의 모든 공식은 실제 게임에서 쓰일 때에는 사전에 RGB 테이블[*][*]로

선연산하여 사용하도록 합니다. ( 그렇지 않고, Pixel 한번 처리할때마다

RealTime으로 연산하면서 구현한다면 치명적인 과부하가 발생합니다. )

15비트 컬러의 경우, Color Dodge를 예로 든다면 Dodge[32][32]의 배열을

준비 한 후,

for ( long bg=0 ; bg<32 ; bg++ ) {

for ( long spr=0 ; spr<32 ; spr++ ) {

Dodge[bg][spr]=(long)((bg*32)/(32.0-spr));

}

(주) 분모측의 32.0으로 소수점을 표현한 이유는 컴파일적인 문제로 Floating

연산을 위한 것입니다.

실제 구현은,

BG와 SPR에 대해 15비트 R,G,B 값을 구해서 사전에 만들어 놓았던 테이블을

참조, 구현하도록 합니다.

아래는 간단한 예문입니다.

long d,e;

WORD r,g,b;

d = dest[0];//배경 버퍼 dest 에서 BG Pixel 을 구해서 d 에 저장.

e = data[0];//SPR Pixel 을 구해서 e 에 저장.

r=Dodge[(d&0x7c00)>>10][(e&0x7c00)>>10];//사전에 만들어 놓을 테이블 참조.

g=Dodge[(d&0x03e0)>>5][(e&0x03e0)>>5];

b=Dodge[d&0x001f][e&0x001f];

dest[0]=(WORD)((r<<10)|(g<<5)|(b));//완성된 색을 배경 버퍼로 전송.

이상입니다.

(주2) 위에 구현된 모든 이펙트 필터를 한마디로 표현한다면 왜곡과 생략이라

할 수 있습니다. 즉 Sprite 에 의해서 표현되어지는 것이 아니라 '스프

라이트에 의해서 왜곡되어지는 배경'이 이펙트 스프라이트에 대한 정의

라 할 수 있습니다. ( 이해가 가시나요? )

(주3) 사족을 하나 달겠습니다. 위의 모든 정보들은 인터넷에서 파오거나,

어디서 보고 들은 것들이 아닙니다. 그야말로 순전히 수많은 시행착오

를 겪은 끝에 구현하게 된 것들입니다. 열심히 더 업그레이드 해주십

시요. 여러분들이 더 열심히 해 주실수록 우리 게임계의 미래는 밝아

집니다. 지켜 보겠습니다.

(주4) 이 모든것을 가능하게 곁에서 도와준 남영이와 늘 옆에서 날카로운

지적으로 날 땀흘리게 했던 응용수학의 달인 경일에게 감사와 영광을...

1997. 12. 27. INGRAM

게제동 강좌란

제 목 [PROG] 브렌슨헴 알고리즘 - 1

작성자 김학규 (neolith)

작성일 03-13 조회수 2663

정영태 (viracoza)

[강좌] 브렌센헴 알고리즘 #1/3 - 직선 02/28 17:46 190 line

제가 이번에 안하던 짓을 하는 이유는

어느 분인가가 브렌센헴 알고리즘을 물어왔기

때문입니다. 다른 고수들 놔두고 왜하필

저한테 물었는지는 잘 모르겠으나, 이왕이면

강좌로 하는 것이 낫다고 생각해서 강좌의

형식을 빌어서 쓰는 것입니다.

그러므로 오늘부터 3회에 걸쳐

브렌센헴 알고리즘만을 강좌하기로 하겠습니다.

처음엔 직선, 다음엔 원, 그리고 타원 순으로요.

브렌센헴 알고리즘이 왜 필요한지는 굳이

쓰지 않겠습니다.

하지만 여러 사람들이 이 알고리즘에 손을

대지 않는 이유는 단지 이 알고리즘이

수학적 지식을 필요로 한다는 지레짐작

때문입니다.

사실 이 알고리즘은 아주 기초적인 수학능력

만 있으면 쉽게 이해할 수 있는 알고리즘입니다.

장점은 모두 아시다시피 속도가 빠르다는 것이고,

단점은 선의 질이 그다지 좋지 않다는 것입니다.

특히 이것은 직선보다 곡선에서 더 드러납니다.

이 브렌센헴 알고리즘을 보완한 알고리즘이

몇개 더 있지만 설명을 생략하겠습니다.

브렌센헴 알고리즘의 가장 핵심이 되는 것은

에러텀이라는 것입니다. 오차이지요.

무한대의 해상도를 갖는 CRT는

존재하지 않으므로 CRT에 선을 그리려면

어쩔 수 없이 오차가 생기기 마련입니다.

이 오차를 이용하는 것입니다.

이 오차가 어느 일정 한도 이상이 되면

점을 찍는 위치를 증가시킵니다.

이해를 돕기위해 좌표계는 컴퓨터가 아니라

일반적인 스퀘어 좌표계를 쓰겠습니다.

│

3│ ???

2│ ???

1│???

└───────────

0 1 2 3 4 5 6 7 8 9

위의 그림은 (1,1)【?(9,3)까지 선을 긋는

모습입니다. 당연히 매끈한 직선이 아니라

정수의 좌표를 갖는 점들의 집합이 되었죠.

설명을 돕기 위해 위의 좌표를 일반화하지

않았습니다. 그냥 가로가 x좌표고 세로가 y좌표

라고 해 두었습니다. 이것을 일반화시키면

설명이 복잡해지거든요.

자~ 이론 설명에 앞서, 선이 그려지는 과정부터

말씀드리죠.

우선 첫번째 점은 1,1에 찍습니다. 그 다음에

x좌표를 증가시킵니다. 그래서 에러텀을 살피고

만약 에러텀이 일정 한도 이하라면 그냥 넘어갑니다.

이렇게 진행하다가 보면 에러텀은 갈수록 커져가고,

나중에는 그 일정 한도라는 값을 넘어서게 됩니다.

그럼 y좌표를 증가시킵니다.

물론 y를 증가시켰으니 에러텀은 어느정도

줄어들겠죠. 에러텀에서 어느 값을 빼면 됩니다.

이 과정을 x좌표가 9가 될 때까지 반복하면 됩니다.

별로 어렵지 않게 이 방법이 실수의 가상좌표상의

점의 정수화와 거의 일치한다는 것을 증명할 수는

있지만 설명하기도 귀찮고, 또 설명한다고 해도

재미가 없어서 생략합니다. (흐-)

브렌센헴 알고리즘을 개략적으로 예를 들어 설명하자면,

그러니까... 무식한 예를 들죠.

만약 점이 0 아니면 1... 식의 정수값을 갖고,

그 증가율이 0.1이라면 어떻게 하겠습니까?

0.1, 0.2, 0.3, 0.4 까지는 그냥 0이라고 하고,

0.5부터 1이라고 하면 되겠죠?

그럼 이것을 아까의 과정으로 설명하죠.

우선 증가율이 0.1이므로...

처음 점은 0.

그 다음엔..

거기에 0.1을 더하면 0.1. 이것은 0.5보다 작으므로

오차는 0.1인채로 넘어가죠.

또 0.1을 더하면 0.2, 이것도 0.5보다 작으므로

오차는 0.2 ...

이런식으로 오차는 계속 늘어갑니다.

이러다가 0.5가 되는 순간 점의 값은 1로 뛰게 됩니다.

그럼 이제 오차는 -0.4가 되죠.

즉 에러에서 0.9를 뺀 것입니다.

이제 또 0.1을 더하면 -0.3으로 아직 0.5보다 작습니다.

또 더하고... 이렇게 하다가 보면 다시 에러텀은

0.5보다 커지고 점의 값은 또한번 증가하게 됩니다.

그렇다면 이것의 스케일을 좀 넓혀보죠.

왜냐하면 당연한 얘기지만 비록 곱셈 없이 덧셈뺄셈만

썼다지만 위의 것은 실수를 썼잖아요.

이것을 정수화 하기 위해선 약간의 연산을 해야 합니다.

그러기 위해선 아주 기초적인 미분식이 들어가는데...

생략하고 결론을 말하죠.

위의 것을 정수화 하고, 다음에 주어진 인수에 따라

재구성하면,

처음의 에러텀은 당연히 0이고,

증가율은 End_X - Start_X ... 즉 X의 변화량,

에러텀의 한계는 X의 변화량을 2로 나눈 값,

에러텀이 한계를 넘었을 때 빼주는 수는 Y의 변화량.

이렇게 됩니다.

그럼 방금 위의 인수를 바탕으로 알고리즘을 설명하면,

"X의 값을 증가시킨 다음에 에러텀에 Delta_X를 더해준다.

그 결과 에러텀이 Delta_X / 2 의 값보다 크거나 같으면

Y의 값을 증가시키고 에러텀에선 Delta_Y를 빼준다.

이 과정을 X가 선을 긋는 끝 좌표에 도달할 때까지 한다."

하나 주의해야 할 것은 위의 경우는 X의 기울기가 Y의

기울기보다 컸을 때의 얘기라는 것입니다.

만약 그 반대라면 진행 과정도 반대가 됩니다.

이해가 가시나요? 제딴엔 최대한 자세히 설명한 것입니다.

아래에 실제 소스를 싣죠.

void line2( int x1, int y1, int x2, int y2, char color )

{

int x, y, temp;

int delta_x, delta_y, half, error = 0;

/* 한상 x2 >= x1, y2 > y1 이 되도록 한다. */

if( x1 > x2 ){

temp = x1;

x1 = x2;

x2 = temp;

}

if( y1 > y2 ){

temp = y1;

y1 = y2;

y2 = temp;

}

/* x, y의 변화량을 구한다. */

delta_x = x2 - x1;

delta_y = y2 - y1;

/* 처음 시작점을 찍는다. */

put_pixel( x1, y1, color );

/* 각 좌표의 기울에 따라 선을 긋는다. */

if( delta_x > delta_y ){

y = y1;

half = (int)( delta_x / 2 );

for( x = x1+1; x <= x2; x ++ ){

error += delta_y;

if( error > half ){

y ++;

error -= delta_x;

}

put_pixel( x, y, color );

}

} else {

x = x1;

half = (int)( delta_y / 2 );

for( y = y1+1; y <= y2; y ++ ){

error += delta_x;

if( error > half ){

x ++;

error -= delta_y;

}

put_pixel( x, y, color );

}

이해가 가셨나 모르겠군요.

위의 예제는 Game13h에서 직접 실행할 수 있도록

만든 것입니다. 함수명을 line2()로 한 것도

Game13h하고 충돌하지 말라고 한 것입니다.

하지만 점찍는 함수를 가진 어떠한 라이브러리에서도

사용하실 수 있습니다.

소스를 보시면 호출한 함수라곤 put_pixel()밖에

없다는 것을 알 수 있을 것입니다.

이 함수의 용도는 지정한 화면상의 위치에 정해진

색으로 점을 찍는 함수입니다.

그러니 이 함수만 만드신다면 어떤 스크린 모드에서도

사용하실 수 있습니다.

만약 기회가 난다면 브렌센헴 알고리즘?보완한

알고리즘을 올리도록 하고, 지금은 이것으로 끝냅니다.

다음엔 원 그리는 부분을 올리도록 하겠습니다.

- ID빌려쓰는 빈대 경민...

게제동 강좌란

제 목 [PROG] 브렌슨헴 알고리즘 - 2

작성자 김학규 (neolith)

작성일 03-13 조회수 1246

정영태 (viracoza)

[강좌] 브렌센헴 알고리즘 #2/3 - 원 03/01 14:52 198 line

저번 강좌에 이어 이번엔 브렌센헴 알고리즘으로

원을 그리는 방법을 살펴 보겠습니다.

아시는 분은 다 아시다시피 이 브렌센헴 알고리즘은

구현이 쉽고 빠른 대신에 그 질이 좋지 못하다는

단점을 갖고 있습니다.

이것은 직선보다 원이 더 심합니다.

특히 타원의 경우엔 별도의 보완책 없이 쓰면

더욱 엉망이 되고 맙니다.

또한 여기선 화면의 종횡비는 계산에 넣지

않기로 하겠습니다.

모두 아시다시피 그래픽 모드마다 화면의 종횡비는

조금씩 다릅니다. 오직 몇가지 모드만이 정사각형

픽셀을 제공하는데, 모드 12h가 대표적인 예이죠.

그래픽 종횡비 보정을 해야 그래픽 모드에 상관없이

제대로 된 원을 그릴 수 있으나,

이번 강좌에선 그 부분을 빼기로 하겠습니다.

물론 그 부분이 어려워서는 아닙니다.

하지만 이 강좌는 브렌센헴 알고리즘만을 설명하기

위한 강좌이므로 주제에서 벋어난 부분의 설명은

가능한 한 줄일 생각입니다.

브렌센헴의 알고리즘은 직선이든 원이든

그 전개 과정은 거의 흡사합니다.

어차피 에러텀에 일정 수를 더하고 그것이

일정 한도가 될 때까지 진행하다가 다음 순간

y의 값이 증가하고...

실제 그 과정에 대한 설명은 전 강좌를 봐 주시기

바랍니다.

그럼 직선과 원이 뭐가 달라지느냐...

이제 그것을 설명할까 합니다.

우선 원은 모든 방향이 대칭이 됩니다.

원을 그릴 때는 기본 4방향 대칭을 이용합니다.

그러나 이럴 경우엔 약간의 문제가 생깁니다.

처음 45도는 제대로 그려지다가 나중엔

X의 좌표 변화율에 비해 Y좌표 변화율이

너무 커져서 점이 떨어지게 됩니다.

그래서 45도씩 그려서 그것을 다시 대칭시킵니다.

이것은 원이 모든 방향으로 대칭된다는

성질로 쉽게 증명이 됩니다.

그러니 실제론 원이라기 보다 곡선으로 이루어진

8각형이라고 하는 것이 낫겠군요.

실제로 원을 그릴 때는 45도 각도만 그리고

그것을 8방향으로 대칭 시킵니다.

그러니 기울기에 따라 그리는 루틴이 갈릴

필요도 없겠죠.

무조건 증가 성분만 있는 부분을 그린 다음에

8방향으로 대칭 시키면 되니까요.

그럼에도 불구하고 원을 그리는 알고리즘은

직선에 비해 신경써줘야 할 부분이 좀 있습니다.

우선 대칭이 되는 네 점을 나열해 보겠습니다.

만약 원점이 (0,0)이라면 임의의 원상의 점 (x,y)는

각각 (y,x), (x,-y), (y,-x), (-x,y), (-y,x), (-x,-y),

(-y,-x)와 대칭됩니다.

만약 원점이 (x0, y0)라면, 이것은 알고리즘에 의해

구해진 (x,y)에 대해,

(x0+x, y0+y), (x0+x, y0-y), (x0+y, y0+x),

(x0+y, y0-x), (x0-x, y0+y), (x0-y, y0+x),

(x0-x, y0-y), (x0-y, y0-x) 의 팔방향으로

대칭된 점들이 구해집니다.

이제 원을 그리는 알고리즘을 위해 실제

원의 방정식에서 각 점의 위치를 구하는 식을

분석해 보기로 하겠습니다.

설명을 쉽게 하기 위해 원점을 (0,0)이라고

하겠습니다. 실제로 이렇게 구해진 x,y는

위의 방법을 사용해 실제 점으로 환원할 수

있습니다. 반지름은 ratio라고 합니다.

우선 원상의 점중에 1/8만을 구합니다.

어느 방향을 하든 상관없지만 이왕이면

x는 증가, y는 감소하는 원의 우상단 부분을

사용합니다. 그럼 x는 0부터 시작해서 y까지

한다고 하면 됩니다.

왜냐하면 x와 y의 반지름에 관한 관계는

서로 동등하므로 만약 이 두값이 같다면 1/8의

지점에 도달한 것이기 때문입니다.

(이런 것까지 증명해줄 필요는 없겠죠?)

물론 y값도 상수가 아닙니다. 그러니 루프의

횟수는 처음부터 정해진 것이 아닙니다.

루프가 진행되어 감에 따라 일정한 규칙에

따라 y좌표도 감소하므로 대체로 처음 정한

y값보다 작은 횟수로 루프가 끝나기 마련입니다.

출발좌표가 (0, ratio)이므로 다음 점의 좌표는

(1, ratio) 이든가 (1, ratio-1)이 될 것입니다.

이 둘중에 어느것인지 판단하는 것은 전 강좌의

직선의 에러텀을 연상하십시요.

다음 점을 구하면 이것이 무엇이든간에 이론적인

원의 점에서 보면 오차가 있습니다.

이 오차의 절대값을 d라고 놓으면,

d = |(x² + y²) - ratio²|

라는 식이 성립합니다.

이제 위에서 얘기한 (1, ratio)와 (1, ratio-1)

를 사용해 오차를 각각 구할 수 있습니다.

그럼 이 오차가 작은 경우가 우리가 구하고자

하는 점이겠죠?

편이상 (1, ratio)의 오차를 d(S₁),

(1, ratio-1)의 오차를 d(D₁)라고 놓겠습니다.

그럼 d(D₁) - d(S₁)의 값이 0보다 작으면

점이 감소한 것이고, 그렇지 않으면 점은 감소하지

않은 것입니다. 점이 감소했다면 그 오차에서

일정 값을 빼 줍니다. 이것은 전 강좌에서도

언급한 적이 있으니 설명은 생략합니다.

이런 과정을 x를 증가시켜가며 진행해서 원의

1/8의 정도를 그릴 때까지 반복합니다.

x가 언제 1/8지점까지 왔는가는 곧 설명합니다.

이정도 했으면 원 그리기 알고리즘의 대략적인

설명이 되었다고 생각합니다.

브렌센헴 알고리즘을 설명하기 위해 약간

바람을 잡은 셈이죠.

이제부터가 진짜 브렌센헴 알고리즘입니다.

위의 대략적인 이해가 끝났다면 스스로

브렌센헴 알고리즘의 구조를 머릿속에

떠올릴 수 있을 것입니다.

수학이 골치아프시다는 분은 그냥 아래 설명과

소스를 보십시요.

저도 수학과지만 수학은 무지 골치아픕니다.

원의 방정식에서 브렌센헴 알고리즘을

이끌어 내는 과정은 생략합니다.

솔직히 말하면 저도 하라면 헛갈려서

못해요. 유도식을 보고서야 할 수 있죠.

흐흐- 이해는 하지만 하라면 못하는 것...

이것이 우리나라 교육의 문제랄까?

얘기가 잠깐 옆으로 샜는데...

간단히 말씀드리죠.

우선 초기값으로 x, y, thres를 설정합니다.

여기서 thres는 에러텀 비슷한 것인데

아주 약간 다릅니다. 어떻게 다른가는

설명이 애매하니 생략합니다.(생략 투성이군...)

x의 초기값은 0, y의 초기값은 반지름, thres는

3에서 지름을 뺀 값으로 합니다.

그리고 루프를 시작하는데...

그 종결조건은 x가 y보다 커지는 경우입니다.

만약 thres가 0보다 작으면 thres를

6 + x * 4만큼 증가시킵니다. 그렇지 않다면

thres는 10 + (x - y) * 4만큼 증가시키고

y를 하나 감소시킵니다.

이렇게 하면 x와 y의 값이 모두 구해지므로

원점을 중심으로 8방향으로 점을 모두 찍습니다.

여기까지가 루프이며, 이제 x를 증가시키면 되죠.

하나 예외적인 상황이 있는데,

반지름이 0인 경우죠. 이럴 경우엔 점 하나만을 찍은

채 함수를 종결합니다.

자, 아래 소스가 있습니다.

void circle2( int x0, int y0, word ratio, byte color )

{

int x, y, thres;

if( ratio == 0 ){

put_pixel( x0, y0, color );

return;

}

y = ratio;

thres = 3 - (ratio + ratio);

for( x = 0; x < y; x ++ ){

if( thres < 0 )

thres += 6 + (x << 2);

else{

thres += 10 + ((x - y) << 2);

y --;

}

put_pixel( x0+x, y0+y, color ); put_pixel( x0+y, y0+x, color );

put_pixel( x0-x, y0+y, color ); put_pixel( x0-y, y0+x, color );

put_pixel( x0+x, y0-y, color ); put_pixel( x0+y, y0-x, color );

put_pixel( x0-x, y0-y, color ); put_pixel( x0-y, y0-x, color );

}

전번 강좌와 마찬가지로 점찍는 함수를 갖춘 다른 모든

프로그램에서 사용이 가능합니다.

이번에도 어제처럼 날림으로 강좌를 끝냈는데,

이유는(핑계는) 전산학도나 수학도를 위한 공식 유도가

아니라 브렌센헴 알고리즘이 이렇다 싶은 정도만

얘기하고 실제로 컴퓨터로 옮기는 것만을 설명하는 것이

이 강좌의 목적이기 때문입니다.

아마 다음 강좌인 타원 그리기 알고리즘은 더욱 날림이

될 것입니다. 원 그리기보다 배는 복잡하니까요.

그리고 제가 브렌센헴 알고리즘을 공부하기 시작한 것도

그렇게 오래되지 않았으니 강좌에서 틀린 부분도 있을

것입니다. 만약 그렇다면 아주 마음 놓고 씹어주세요.

언제든 칼맞을 준비가 되어 있습니다. (헤-)

그럼 조금이라도 도움이 되었기를...

- ID빌려쓰는 빈대 경민...

게제동 강좌란

제 목 [PROG] 브렌슨헴 알고리즘 - 3

작성자 김학규 (neolith)

작성일 03-13 조회수 1233

정영태 (viracoza)

[강좌] 브렌센헴 알고리즘 #3/3 - 타원 03/02 21:39 184 line

안녕하세요?

제가 개강 때문에 좀 바빠서 강좌가

늦어졌습니다. 원래 계획으론 하루에

하나씩 3일에 다 끝낼려고 했는데...

이번엔 브리슨헴 알고리즘 강좌

마지막인 타원 그리기입니다.

하나 미리 얘기해 둘 것은,

비록 여기에 브렌센헴 알고리즘의

강좌라지만 이 타원 그리기 알고리즘은

브렌센헴 알고리즘이 아닙니다.

실제 그 구현을 보면 브렌센헴 알고리즘과

유사하지만 어느 참고서적에서도 이것을

브렌센헴 알고리즘이라고 하지 않습니다.

하지만 연관관계도 있고, 그 구현면에서도

유사하니까 이 강좌에선 같은 계열에서

취급하는 것입니다.

이점 착오 없으시기 바랍니다.

척 보기에도 알 수 있듯이, 타원의 방정식은

원의 방정식보다 어렵습니다.

그리고 속도도 더 늦고요.

하지만 약간 변형을 하면 상당히 빠른 속도를

낼 수도 있습니다. 이 알고리즘의 이름은

모르겠지만 구현 방법면에선 할 하드베르그의

알고리즘과 유사하므로 그쪽 계통이 아닌가

생각됩니다. 속도는 무척 빠르지만

여기서는 다루지 않겠습니다.

만약 얘기를 하자면 원그리기까지

또다시 거슬러 올라가야 하기 때문입니다.

타원은 원의 경우와는 달리 4방향이 대칭됩니다.

그리고 단순 증가방식만을 쓰지 않습니다.

타원의 경우엔 선그리기처럼 45도를

기점으로 그 기울기(?)가 다르므로 구현할 때도

이 두경우를 나누어서 해 주어야 합니다.

그러니 실제론 4분의 1만을 그리고 나머지는

대칭으로 찍으면 되고, 또 이 1/4도 두가지로

나누어서 그려야 합니다.

이 알고리즘을 위한 설명은 따로 존재하지 않고

앞에서 한 설명을 바탕으로 유도식만을

보입니다. 실력이 있는 분들은 이해하실 수 있을

것입니다. 만약 이해가 안된다면 다른 참고서적들을

참고하세요. 아마 많은 그래픽 서적에서 이것을

다루고 있을 것입니다.

유도식이 긴 관계로 초기항과 결과만을 쓰기로

하겠습니다.

우선 타운의 방정식이

(x0 - x)? (y0 - y)?

──── - ──── = 1

a? b?

이라는 것은 후진 중학교 안나온 이상 다 아는

사실. 이것을 약간 변형시켜서,

b?x? + a?y?- a?b? = 0

이라고 놓고 이것을 앞의 방법을 통해 d를 구하면

d = b?(x+1)?+a?(y-1/2)?-a?b?

이고, 각각 d₁,d₂, d₃... 에 대해

d₂- d₁, d₃- d₂... 등을 구하면

d₂- d₁= -2a²y₁

d₃- d₂= -2a²y₂

이다. 이것은 기울기, 즉 dy/dx가 -1 이상일

때이고, 만약 기 이하라면

d₂- d₁= -2a²y₁+ a²

으로 바뀝니다.

또한 생각해 줘야 할 것이 한두개 더 있지만

설명을 생략하기로 합니다.

이렇게 생각해 줘야 할 경우가 두가지인데다가

그 성격이 다르기 때문에 타원을 그리는 데엔

크게 나누어 두개의 다른 루프를 돌려야 합니다.

게다가 루프 내에서 당연히 판단 루프가

들어가죠. 총 4가지의 다른 상황을 처리하는

함수로 타원 그리는 함수는 구성되어 있습니다.

대략적으로 설명한대다가 알고리즘을 구현하기

위해 충분한 자료를 다 제시하지 못했습니다.

이유는 앞서 말했듯이 알고리즘 자체에

대한 강좌라기 보다는 소개와 실제 그 소스를

공개하는 데에 그 목적을 두기 때문입니다.

void ellipse2( int x0, int y0, word a0, word b0, byte color )

{

int x = 0, y = b0;

long a = a0, b = b0;

long a_squ = a * a;

long two_a_squ = a_squ << 1;

long b_squ = b * b;

long two_b_squ = b_squ << 1;

long d, dx, dy;

d = b_squ - a_squ*b + (a_squ >> 2);

dx = 0;

dy = two_a_squ * b;

while( dx < dy ){

put_pixel( x0+x, y0+y, color );

put_pixel( x0-x, y0+y, color );

put_pixel( x0+x, y0-y, color );

put_pixel( x0-x, y0-y, color );

if( d > 0 ){

y --;

dy -= two_a_squ;

d -= dy;

}

x ++;

dx += two_b_squ;

d += b_squ + dx;

}

d += ( 3*(a_squ - b_squ)/2 - (dx+dy)/2 );

while( y >= 0 ){

put_pixel( x0+x, y0+y, color );

put_pixel( x0-x, y0+y, color );

put_pixel( x0+x, y0-y, color );

put_pixel( x0-x, y0-y, color );

if( d < 0 ){

x ++;

dx += two_b_squ;

d += dx;

}

y --;

dy -= two_a_squ;

d += a_squ - dy;

}

앞의 두 강좌와 마찬가지로 점찍는 기능을 가진 다른

모든 프로그램에서 실행이 됩니다.

아마 설명이 그다지 잘 되지 못했을테고,

게다가 알고리즘 구현에 필요한 것을 전부

설명하지 못했기 때문에 설명 자체만으로 프로그램을

짤 수는 없을 것입니다. 설명이 미흡하다고 생각하면

다른 참고서적을 살피고, 실력이 있으시다면

소스와 앞에서 설명한 몇가지 자료만으로 직접 분석해

보시기 바랍니다.

미흡한 강좌, 끝까지 봐 주신 여러분께 감사드립니다.

한번 그래픽 이론을 알고 싶다고 생각하고 보신

분들은 실망이 크시겠지만 그냥 한번 어떤 것인가

맛만 보겠다고 생각하시고 강좌를 보신 분들은

약간 도음이 되셨을 것입니다.

요즘 게임들이 테크닉 위주로 많이 나가는데,

이제는 테크닉보다 탄탄한 자료 구조와 이론을

바탕으로 그곳의 위에 화려한 테크닉의 옷을

입힌 알찬 게임이 많이 나왔으면 좋겠습니다.

특히 3차원 게임에 관한 관심이 높아지는데

조금 아는 듯 싶다 하는 분들이 자신의 소스를

공개하길 꺼리는 것 같군요.

저도 좀 많이 배우고 싶은데...

아무쪼록 혹시나 3차원 그래픽 쪽으로 지식이

조금 있는 분께서 이 글을 읽으신다면

우리나라 게임의 발전을 위해서도

소스를 팍팍 공개하시고, 강좌도 하시면서

자신의 지식을 아낌없이 나누어 주시길 바랍니다.

그럼...

- ID빌려쓰는 빈대 경민...

덧붙이는 말 : 앞 강좌에서 '브렌센헴'이라는 발음을 썼는데,

실은 '브리슨헴'이라는 발음이 맞습니다.

그리고 강좌에 의문이 있으신 분은 메일 주세요.

강좌와 직접 관계없는 질문도 상관 없습니다.

게제동 강좌란

제 목 [PROG] 신기한 벡터의 내적과 외적

작성자 이태경 (수퍼유저)

작성일 08-23 조회수 1013

벡터의 내적과 외적, 법선벡터를 알자.

먼저 벡터의 내적과 외적을 알기전에 벡터에 대해 조금만 얘기하겠습니다.

당연히 수학적인 부분이지만 초등학생도 알수 있도록 쉽게....

1. 벡터

2차원 좌표상에 점을 표시할때 일반적으로 x,y 두개의 좌표를 가지고

화면의 점을 그린다. 이때 수학적으로 점이란 눈에 안보이는 것이지만

점을 구성하는 좌표 성분으로 P(x,y)라고 지정한다.

벡터란 원점을 기준으로한 점이라고 생각하면 쉽게 설명할 수 있을 것

이다. V(x,y)를 표시할때 결국 (0,0)에서 (x,y)의 방향을 가르키는

말이며 v(2,2)와 v(3,3)은 결국 크기만 다르지 같은 방향을 가르키고

있다.

2. 단위 벡터의 특성

단위 벡터란 크기가 1인 벡터를 얘기한다.

0 에서 1까지의 실수는 아무리 곱해서 절대로 1을 넘지 않는다.

이 특성이 단위 벡터에서도 나타난다.

단위 벡터끼리 곱하는 연산은 1000만번을 한다하더라도 단위 벡터다.

사실 위의 예기는 아주 중요한 얘기이며 이 간단한 사실만으로

연산을 아주 간소화 할수 있다.

그럼, 단위 벡터는 어떻게 만드는가?

v(1,1)와 v(2,2)는 크기가 다르지만 방향을 같다고 했다.

두 벡터를 크기는 무시하고 오직 방향만 계산하고 싶다고 할때

단위 벡터를 만든다. 결국 크기는 1이니까..

같은수에다 같은수를 나누어 보라..

예를 들어 8 / 8 = 1, 7676 / 7676 = 1

역시 1이다.

단위 벡터도 이렇게 구한다.

벡터 v(x,y)가 있을때 벡터의 크기는 sqrt(x*x + y*y)이다.

그럼, 이걸로 나누면 땡이다.

v = sqrt(x*x + y*y);

vx /= v ;

vy /= v ;

이제 벡터의 크기를 구해보자..

크기 = sqrt(x*x + y*y)는 1이 나와야 한다.

이것은 영어로 Normalize라고 한다.

3. 벡터의 내적

이제 좀 어려운 부분을 얘기 하겠습니다.

벡터의 내적은 꼴도보기 싫은 수학정석에 나와 있습니다.

영어로 DotProduct 혹은 inner-Product, Scalar-Product라고 하더군요..

벡터의 내적 공식은 두 벡터가 있을때 두 벡터 사이의 각도를

구하는 공식이죠..

그럼.. 꼴도보기 싫은 수학정석에

cos(theta) = a*b / |a|*|b| 라고 되어 있습니다.

(참고) *는 곱셈이 아니고 . 이지만... 표기할게 없어서..

공식이 어떻게 나왔나고 묻지는 마세요.. 책에 그렇게 되어 있기에..

위 공식에서 만일 a와 b가 단위 벡터라면 |a|*|b|는 1이겠지요..

그럼.. cos(theta)= a*b로 간략화 營윱求?

a*b 벡터의 연산은 성분끼리 곱하면 됩니다.

cos(theta) = a_x*b_x + a_y*b_y ;

(예)

float a_x, a_y, b_x, b_y;

float v, costheta, theta;

a_x = 1.0; a_y = 3.0;

b_x = 3.0; b_y = 1.0;

// 먼저 단위 벡터로 만든다.

v = sqrt(a_x * a_x + a_y * a_y);

a_x /= v;

a_y /= v;

v = sqrt(b_x * b_x + b_y * b_y);

b_x /= v;

b_y /= v;

theta = a_x*b_x + a_y*b_y ;

costheta = cos(theta);

음.. 이제 costheta를 구했다면 황당한 값이 나옵니다.

이걸가지고 어떻게 하란 말야..

cos(theta) = rad 라고 했을때

theta = acos(rad) 이렇게 역으로 구할수 笭윱求?

그럼 위의 프로그램에 더 첨가합니다.

theta = acos(costheta);

결국 우리가 바라는 벡터 사이의 각이 나왔습니다.

신기하져?

(참고) 라디안 값

일반적으로 sin, cos, tan 함수에서 sin(theta) = rad 일

theta = asin(rad) 이렇게 역함수가 존재 합니다.

tan는 atan 흔히들 아크 함수라고 하져..

그리고 각도를 얘기할때 0~360도 얘기하는 것은 Degrees 값이라고

하며 수학에서는 보통 Radian 값을 씁니다.

0에서 180까지의 Degree 값을 얘기할때 라디안 값은

0에서 3.141592(즉 PI) 값까지 나오지요..

180 : 3.141592 = degree : rad 이렇게 되지요..

rad = degree * 3.141592654f / 180 ;

degree = rad * 180 / 3.141592654f ;

그럼. 다시 벡터를 얘기합니다.

theta = acos(costheta); 에서 나온 값은 라디안 값이므로

degree = theta* 180 / 3.141592654f ;

해보면 일반적인 각도가 나옵니다.

4. 벡터의 외적

벡터의 외적이 꼴도 보기 싫은 고등학교 수학 정석에 있었는지는

잘 모르겠네요.. 뒷장까지 본적이 없어서..

벡터의 외적은 그럼 무엇일까요? 벡터 사이의 각이 아닌

반대 방향 각을 구하는 공식일까요? 아닙니다.

벡터의 내적과는 성격이 좀 다릅니다.

벡터의 내적은 결국 라디안 실수 값이 나오지만

외적을 구하는 공식은 그냥 벡터가 하나 더 생깁니다.

두개의 벡터가 있을 기준점에 수직으로 못을 하나 꽂으면

못 방향으로 벡터가 하나 생깁니다. 두 벡터에 수직인 벡터

가 하나 더 생기는 셈이지요..

영어로 CrossProduct라고 하져..

그림으로 설명하면 더 쉬운데... 쩝..

v1(x,y,z)와 v2(x,y,z)가 있을 (0,0,0)을 출발점으로 한 위로

우뚝선 벡터 n(x,y,z)가 하나 더 생긴단 말이져..

두벡터에 수직인 벡터는 사실 두게 있습니다.

위아래...

보통 시계 방향이냐 반시계 방향이나 따라서 한가지만 뽑아냅니다.

다음은 내적을 구하는 연산입니다.

외우지는 마세요.. 그냥 베껴 쓰면 되니깐...^^;

n_x = v1_y * v2_z - v1_z * v2_y;

n_y = v1_z * v2_x - v1_x * v2_z;

n_z = v1_x * v2_y - v1_y * v2_x;

주의 하실점은 반드시 벡터를 단위벡터로 만들고 하세용..

5. 법선 벡터

법선 벡터는 3D 그래픽 프로그래밍에서 흔히 노말 벡터라고 합니다.

3차원 상에 점(vertex)가 3개가 있다고 합시다.

그럼.. 3개의 버텍스 사이에 면이 생깁니다. 일종의 평면이지요..

이 노말 벡터는 의 앞뒤를 가르키는 벡터입니다.

면을 앞 뒤를 구분하는 이유는 바로 연산량과 관계 있습니다. 구와 같은

물체를 안쪽면까지 그린다면 엄청 느려지겠지요.. 그래서 뒷쪽 면은

연산에서 제외 시켜 버립니다. 이것은 Cull_face 혹은 Cull_mode라고 하져..

또한 노말 벡터는 라이트와 밀접한 관련이 있습니다. 무슨 말인가 하면

당구를 생각합시다. 공을 한쪽 벽에 튀길때 들어 오는 각하고 나오는 각하고

같습니다.

(그림) 법선n

i | .o

. | .

-------------------------당구벽

당구공이 벽과 부딪혀서 들어갈때 각은 법선과 당구공 방향 벡터와 내적으로

구할수 있습니다. 결국 이 내적의 두배의 각도로 튕켜져 나옵니다.

들어가는 공의 방향 벡터가 i라고 하고

법선을 n, 튕겨져 나올 방향 벡터가 o라고 했을때

o = 2(i*n)n - i; 란 벡터 공식이 나옵니다.

(이것도 어떻게 나왔나고 뭍지 마세요..그냥 책에 있음)

식이 좀 어렵죠..

c/c++로 풀이하면..

// 여기서 쓰인 벡터는 노말 벡터로 미리 만들어 줘야 합니다.

// 일단 i 벡터의 방향을 뒤 집고..

i_x = -i_x;

i_y = -i_y;

rad = 2 * ( n_x * i_x + n_y * i_y );

o_x = rad * n_x - i_x;

o_y = rad * n_y - i_y;

이것도 신기하져.. 이걸 잘 응용하면 당구 겜도 만들어요..

(공하고 부딪힐때는 공끼리 부짖히는 점을 법선 벡터로 두면..)

잠시 삼천포로 빠졌군요..

결국 빛을 표면에 뿌릴때 반사되는 각도를 계산하기 위해서 필요한거져..

위의 예제는 2개의 벡터를 가지고 예기 했지만 3D 그래픽에서는

버텍스가 3개입니다. 그럼.. 점 하나를 기준으로 (0,0,0)으로

이동 시켜 버려면 2개만 가지고 위의 외적으로 노말을 구할 수 있습니다.

다음은 노말벡터을 구하는 예제입니다.

물론 연산에 들어가지전 단위 벡터로 만드는 건 잊지 마세요

v1[0] = v0[0] - v1[0];

v1[1] = v0[1] - v1[1];

v1[2] = v0[2] - v1[2];

v2[0] = v1[0] - v2[0];

v2[1] = v1[1] - v2[1];

v2[2] = v1[2] - v2[2];

result[0] = v1[1] * v2[2] - v1[2] * v2[1];

result[1] = v1[2] * v2[0] - v1[0] * v2[2];

result[2] = v1[0] * v2[1] - v1[1] * v2[0];

대충 아시겟져...

이것만 알면 3D 그래픽에 꼭 핵심적인 벡터 연산은 아신겁니다.

추신: 벡터는 참 신기하져? 도강이라도 하세요..

iMusicSoft 주임 연구원 이태경 ( 저 대전 살아요..)

게제동 강좌란

제 목 [PROG/초보] WAV CHUNK에 대한 이야기... ^^;

작성자 박한규 (어셈블리)

작성일 12-22 조회수 291

강좌 (3)에서 WAV에대한 이야기를 하였다.

제가 미처 빼먹은 부분이 있어 추가하고자 한다.

바로 청크라는 부분인데... 본 강좌는 여러가지의 WAV파일이 아닌

Window PCM포맷을 사용한다는 전제하여 강좌를 하여 청크라는 것을

빼먹게 되어 사과의 문을 쓰겠습니다.

보통 흔히 사용하는 WAV파일 포맷들이 Window PCM을 많이 사용하고 있습니다.

(필자 역시 그 포맷을 즐겨 사용합니다.)

보통 MP3화일을 WAV파일로 Decoding을 하여 얻는 파일 포맷이 바로

Window PCM포맷입니다.

현재 강좌를 꾸준히 보셨던 독자들께서는 이런 포맷들에 대해서는

그렇게 신경을 안쓰시고, 44바이트 건너뛰면 곧바로 data청크를 만날수가 있습니다.

하지만, 제게 청크에 대한 질문을 하셨던 내용은 다음 사항이 많았습니다.

"어떤 WAV파일은 읽어지고, 어떤 WAV는 읽어 지지 않습니다."

"이건 확실히 mmio를 이용한 청크 검색별로 읽어 가야하지 않을까요?"

오호...이런 질문 메일이 음청나게 많더군여...T_T;

네에 제게 질문을 주셨던 분들의 말이 맞습니다.

WAV파일의 포맷 종류가 매우 다양하기 때문입니다.

"참고로 COOL EDITOR라는 사운드 프로그램을 사용해보시길..."

제가 알고 있는 사운드 파이 포맷은 한 5가지 정도입니다.

그 중에서 일반적으로 널리 쓰이는 Window PCM 포맷을 초점을 맞추어

강좌를 써나간 겁니다. 다시 한번 이점에 대해서 양해를...

[WAV FILE FORMAT]

1. Window PCM

2. Window ADPCM

3. IMA ADPCM

4. ACM Wave

5. Mu/Law Wave

이렇게 다섯가지 입니다.

여기서 위 5가지의 포맷은 그렇게 크기 바뀌지 않습니다.

Window PCM에서 보았던 청크들중에서 한가지가 더 추가 한 것뿐입니다.

바로 "fact"라는 청크인데여...

이 청크에 대한 의미는 정확히 저도 잘 모르겠습니다.

그런데 한가지 저 청크를 조심스럽게 간단히 스킵을 하구...

읽게 되니까...사운드는 제대로 나오더군여... ^^;

그리고, ADPCM같은 경우의 포맷은 주로, 동영상 제작에 사용되는

사운드 포맷으로 널리 알려져 있는 포맷이기도 합니다.

압축된 포맷이죠...그래서 이 포맷은 일반 WAV포맷과 별다른 내용은

없지만, 그냥 데이터 필터링을 하지않구 그냥 출력하게되면,

치지익 하는 굉음이 나오게됩니다.

그리고, WAV파일을 재생하기 위한 필수 기본조건은 정확한 헤더를 얻는

방법을 아는것이라고 생각됩니다.

사운드를 재생하기에 앞서 재생하기 위한 충분한 정보가 제공되어야

하니깐여...^^;

ADPCM포맷의 WAV파일의 데이터 청크 내용은 저도 잘 모르겠습니다. ^^;

아~~~ 강좌 (3)에서는 조회수가 떨어질거라구 예상했었는데..흑흑...

역시나...너무 내용이 빈약 했던것 같군여...^^;

ADPCM이외의 포맷은 강좌 (4)에서 다루도록 하겠습니다.

그리고, 이쁘장한 재생기 프로그램 소스를 제공 해드리겠습니다.

좀 강좌 (4)의 내용은 음청나게 길어질듯...^^;

즐거운 시간 되십시여...^^;

유니티 UI 버튼 다운, 업 이벤트 처리하기

래머 — Mon, 18 Dec 2017 13:11:59 +0900

NGUI같은경우 버튼의 눌림, 눌림 해제를 받을 수 있는데 반해서 유니티의 버튼은 클릭 이벤트만 등록이 가능한것 같습니다.

게임을 만들다 보면, 버튼이 눌려있는 동안 어떤 액션을 계속 수행하다가 눌림이 해제될때 액션을 중지 하는것과 같은 기능이 필요할때가 많은데

아래는 유니티의 버튼을 통해서 해당 기능을 구현하는 방법의 예입니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.EventSystems;
 
public class PointerListener : MonoBehaviour, IPointerDownHandler, IPointerUpHandler
{
    bool _pressed = false;
    public void OnPointerDown(PointerEventData eventData)
    {
        Debug.Log("버튼이 눌려지고 있음");
        _pressed = true;
    }
 
    public void OnPointerUp(PointerEventData eventData)
    {
        Debug.Log("버튼 눌림이 해제됨");
        _pressed = false;
    }
    // Use this for initialization
    void Start () {
        
    }
    
    // Update is called once per frame
    void Update () {
        if (_pressed)
        {
            //버튼이 눌려진동안 액션 
        }    
    }
}
 
Colored by Color Scripter
cs

해당 스크립트를 버튼에 부착하고 사용하면됩니다.

Node mcu 와이파이 속도 테스트

래머 — Sun, 26 Nov 2017 00:12:57 +0900

노드 mcu 라는 재미있는 녀석을 발견해서 가지고 놀다가

와이 파이 전송속도가 얼마정도 나올지 테스트 해보고 싶어졌습니다.

대충 서버를 만들고, 노드 mcu쪽은 와이파이 클라이언트 예제를 좀 수정했는데

테스트 방법은 다음과 같습니다.

서버측에서는 tcp서버소켓을 열고 특정포트를 리슨하고 있습니다.

클라이언트쪽에서는 와이파이연결을 초기화 하고, 서버의 ip와 포트에 WIFIClient를 통해서 접속합니다.

접속이 이루어지면 노드쪽에서는 특정한 값으로 초기화된 1024바이트 길이의 배열을 전송을 하고

서버에서는 클라이언트의 내용을 수신해서 내용물을 검사해서 오류가 있는지 확인하고

수신된 바이트 수를 기록해뒀다가

매1초 경과시 마다 수신받은 바이트수를 출력하는 형태입니다.

클라이언트(노드mcu)는 일단 서버에 패킷을 보내고 나서 서버로 부터 다음 패킷을 보내라는 응답을

받기전까지는 다음 패킷을 보내지 않습니다.

아래는 테스트 영상입니다.

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

해외어떤사이트에서 노드mcu전송속도가 형편없다고 들었는데

비록 내부 네트워크간의 전송이지만 생각보다 속도가 잘나오는거 같습니다.

70kb ~ 200kb정도 나오는거 같습니다.

한가지 문제점은 노드mcu에 달린 안테나가 부실해서 그런지 전력소모가 많아서 그런지 모르겠는데

매우 불안정해서 연결이 매우 쉽게 끊어지는거 같습니다.

nodemcu v3 핀맵

래머 — Sun, 12 Nov 2017 01:02:37 +0900

윈도우 조이스틱 사용

래머 — Tue, 18 Apr 2017 12:21:00 +0900

https://msdn.microsoft.com/ko-kr/library/windows/desktop/dd797987(v=vs.85).aspx

윈도우 api를 통해 조이스틱 사용하는 법

Getting the Driver Capabilities(드라이버 능력확인)

The following example uses joyGetNumDevs and joyGetPos to determine whether the joystick services are available and if a joystick is attached to one of the ports.

다음은 조이스틱 서비스를 이용할 수 있고 포트에 연결되었는지 결정하기위해 joyGetNumDevs와 joyGetPos를 사용하는 예이다.

C++

JOYINFO joyinfo; 
UINT wNumDevs, wDeviceID; 
BOOL bDev1Attached, bDev2Attached;

    //조이스틱 디바이스 개수가 0이면
    if((wNumDevs = joyGetNumDevs()) == 0) 
        return ERR_NODRIVER; 

    //조이스틱1이 연결되었는가?
    bDev1Attached = joyGetPos(JOYSTICKID1,&joyinfo) != JOYERR_UNPLUGGED; 

    //조이스틱2가 연결되었는가?
    bDev2Attached = wNumDevs == 2 && joyGetPos(JOYSTICKID2,&joyinfo) != 
        JOYERR_UNPLUGGED; 

    //조이스틱1, 2중하나라도 연결되었다면 
    if(bDev1Attached || bDev2Attached)   // decide which joystick to use 어떤조이스틱을 사용할지결정
        wDeviceID = bDev1Attached ? JOYSTICKID1 : JOYSTICKID2; 
    else 
        return ERR_NODEVICE;

Capturing Joystick Input(조이스틱 입력 획득)

Most of the code controlling the joystick is in the main window function. In the following portion of the message handler, the application calls joySetCapture to capture input from the joystick JOYSTICKID1.

조이스틱을 제어하기위한 코드의 대부분은 메인 윈도우 함수안에 있다. 다음의 메시지 핸들러의 일부에서 어플리케이션은 JOYSTICKID1조이스틱에서 입력을 획득하기 위해 joySetCapture를 호출한다.

C++

case WM_CREATE:

    //리턴값이 0이 아닌경우 요청이 실패한것이다.
    if(joySetCapture(hWnd, JOYSTICKID1, NULL, FALSE)) 
    {

        //비프음을 출력하고 메시지 박스로 안내 후 프로그램 종료
        MessageBeep(MB_ICONEXCLAMATION); 
        MessageBox(hWnd, "Couldn't capture the joystick.", NULL, 
            MB_OK | MB_ICONEXCLAMATION); 
        PostMessage(hWnd,WM_CLOSE,0,0L); 
    } 
    break;

Processing Joystick Messages(조이스틱메시지처리)

The following example illustrates how an application could respond to joystick movements and changes in the button states. When the joystick changes position, the application moves the cursor and, if either button is pressed, draws a bullet hole on the desktop. When a joystick button is pressed, the application draws a hole on the desktop and plays a sound continuously until a button is released. The messages to watch are MM_JOY1MOVE,MM_JOY1BUTTONDOWN, and MM_JOY1BUTTONUP.

다음의 예는 어플리케이션이 어떻게 조이스틱의 이동과 버튼의 상태변화에 응답할 수 있는지 예를 보여준다. 조이스틱의 위치가 변할때 어플리케이션에서 커서를 이동시키고, 버튼이 눌릴경우, 데스크탑에 총알구멍을 그린다. 조이스틱 버튼이 눌리는경우, 어플리케이션은 구멍을 그리고 동시에 버튼 눌림이 해제될때까지 사운드를 플레이 한다. 해당 메시지 들은 MM_JOY1MOVE, MM_JOY1BUTTONDOWN, MM_JOY1BUTTONUP 으로 관찰된다.

C++


case MM_JOY1MOVE :                     // changed position  위치이동됨
    if((UINT) wParam & (JOY_BUTTON1 | JOY_BUTTON2)) //wParam에는 버튼 눌림상태가 포함되있다.
        DrawFire(hWnd); 
    DrawSight(lParam);                 // calculates new cursor position 
    break; 
case MM_JOY1BUTTONDOWN :               // button is down  조이스틱1 버튼눌림
    if((UINT) wParam & JOY_BUTTON1)     //1번 버튼이 눌린경우
    { 
        PlaySound(lpButton1, SND_LOOP | SND_ASYNC | SND_MEMORY); 
        DrawFire(hWnd); 
    } 
    else if((UINT) wParam & JOY_BUTTON2)  //2번 버튼이 눌린경우
    { 
        PlaySound(lpButton2, SND_ASYNC | SND_MEMORY |  SND_LOOP); 
        DrawFire(hWnd); 
    } 
    break; 
case MM_JOY1BUTTONUP :                 // button is up , 조이스틱1 버튼 눌림해제
    sndPlaySound(NULL, 0);             // stops the sound 
    break;

유니티 애셋스토어 구입애셋 다운로드되는 경로

래머 — Wed, 1 Mar 2017 17:02:05 +0900

C:\Users\사용자이름\AppData\Roaming\Unity\Asset Store-5.x\

에 다운받은 애셋이 있다.

유니티 텍스쳐 직접조작

래머 — Tue, 14 Feb 2017 17:33:17 +0900

Texture2D.GetPixels

https://docs.unity3d.com/540/Documentation/ScriptReference/Texture2D.GetPixels.html

Texture2D.GetPixels32

https://docs.unity3d.com/540/Documentation/ScriptReference/Texture2D.GetPixels32.html

해당 텍스쳐의 내용을 Color 또는 Color32형태로 얻어온다.

이 기능을 사용하기 위해서는 반드시 텍스쳐에 읽기/쓰기 가능 플래그를 임포트 셋팅에서 설정해야 한다.

Texture2D.SetPixels

https://docs.unity3d.com/540/Documentation/ScriptReference/Texture2D.SetPixels.html

Texture2D.SetPixels32

https://docs.unity3d.com/540/Documentation/ScriptReference/Texture2D.SetPixels32.html

이함수들은 오직 ARGB32, RGB24, Alpha8포맷의 텍스쳐들에만 작동한다. 또한 텍스쳐들은 읽기 가능 플래그가 설정되어 있어야한다.

유니티 Editor 폴더내에 있는 Resources폴더

래머 — Sun, 29 Jan 2017 09:28:34 +0900

Editor폴더내에 Resources폴더를 만들경우 유니티의 Resources.Load함수를 통해서 리소스 로드가 가능하다.

단, 빌드시에는 Editor/Resources 폴더의 리소스 들은 제외된다.

MMORPG 입니다.

래머 — Thu, 29 Dec 2016 06:32:15 +0900

5년경 지나서 이젠 기억도 가물가물합니다.

MMORPG제작시의 자료입니다.

기억을 더듬어 서버를 셋팅하고 플레이 가능한 상태로 만들어 봤습니다.

아래는 게임영상입니다.

해당 게임은 베타테스트까지만 진행하고 회사가 없어지는 바람에 출시는 못했습니다.

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

아래는 그때당시 제작했던 툴중하나입니다.

MFC로 만들었고 자체엔진이었습니다.

밤새며 셰이더 프로그래밍 하던 기억이 나네요.

이제는 유니티나 언리얼같은 훌륭한 게임엔진들을 쉽게 사용가능하다보니

이런것들이 별 의미가 없지만, 그래도 밑바닦 부터의 경험이 많은 도움이 되었던것 같습니다.

이프로젝트 당시 제가 맡았던 파트는 서버, 엔진, 클라이언트 전체 파트였지만, 주로 서버와 엔진쪽 작업을 했던것 같습니다.

아래는 툴의 작동영상입니다.

이툴은 게임 배경을 편집하거나 지형내에 몬스터배치를 한다거나 하는 역할입니다.

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

아래영상은 바로위 게임 개발전에 작업했던 MMORPG아더스의 플레이 영상입니다.

당시에 저는 프로그램파트 전체를(서버, 엔진, 클라이언트, 각종툴작업) 맡아 작업을 했었습니다.

아더스의 경우 게임아지트를 통해서 일차로 출시를 했고 후에 FDISK를통해서도 서비스를 진행했었습니다.

기획1, 프로그래밍1, 그래픽1해서 3인으로 작업을했었습니다.

그래픽이 구려보이긴합니다만, SSAO, 캐스케이드셰도우맵 등 그당시 나름 최신의 기술들을 심혈을 기울여 구현했었습니다.

최신의 스피드트리 엔진도 도입했습니다.

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

버스터마스터 for Kakao입니다.

래머 — Thu, 29 Dec 2016 06:11:07 +0900

첫 모바일 게임 버스트 마스터 for Kakao입니다.

2013년도 경에 출시 했습니다.

프로그램 파트 전체를 맡아 진행했습니다.

게임서버는 c# 비동기 소켓 기반으로 제작했고

JSP 기반으로 운영툴 및 일부 기능을 제작했습니다.

클라이언트는 유니티 4버전대로 제작했습니다.

유클라우드의 클라우드서버를 이용해 서비스 했습니다.

현재는 서비스 중지 상태입니다.

아래는 게임영상중 일부입니다.

소셜카지노 게임

래머 — Thu, 29 Dec 2016 06:02:02 +0900

가장 최근의 프로젝트로

페이스북 소셜 카지노 게임입니다.

서버파트에서

게임서버 제작,

각종 시뮬레이터 및 게임로직 구현,

각종 운영툴 제작(통계생성, 통계조회, 메일 발송서비스, 페이스북 알림메시지 발송서비스),

페이스북 연동(회원연동, 결제시스템연동, 웹백엔드 기반작업)

아마존 웹서비스 구성(ec2, elb, s3, cloud front, 각종 서버 셋팅(웹, db등등))

등을 맡았습니다.

클라이언트 파트에서는

액션스크립트3 기반의 tcp 통신 네트워크 모듈개발

각 게임별 서버 연동 API개발

기타 웹백엔드와 통신 및 데이터 구축 모듈 개발

클라이언트 파트 결제모듈 개발

등을 맡았습니다.

게임서버는 c#비동기 tcp소켓 서버입니다.

윈폼, 윈도우 서비스, 콘솔, 리눅스 데몬등(모노4.5기반에서)으로 작동가능합니다.,

DB는 MSSQL을 사용했습니다.

버스터마스터 게임 제작시 만들었던 c# 비동기 네트워크 모듈을 사용했는데, 다년간 개선하여 더욱 견고하게 작동하도록 했습니다.

웹의 경우 JSP(스프링)기반으로 아파치 + 톰캣 구성으로 현재도 서비스 중입니다.

아래는 게임 영상입니다.

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

아래는 제작한 시뮬레이터 중 하나의 영상입니다.

시뮬레이터의 경우 게임마다 존재하는데 게임의 특성에 따라서 구성에 차이가 있습니다.

역할은 게임데이터를 생성, 편집, 서버에 업로드, 게임해보기, 데이터추출, 게임시뮬레이션해보기

시뮬레이션 통계확인 등입니다.

윈폼(c#)으로 제작했습니다.

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

CMS웹페이지를 통해서 전반적인 운영이 가능하지만 일부툴의 경우 어플리케이션으로 만들기도 했습니다.

아래는 통계 추출용툴입니다.

서버에 누적된 로그를 조회해서 보여주거나 엑셀 파일로 저장하는 기능을 제공합니다.

윈폼으로 제작했고 서버의 경우 Node.js를 이용했습니다.

목적에 적합한 다양한 기술을 활용하는 재미가 있는것 같습니다.

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

구글플레이 유저 토큰 서버 인증

래머 — Fri, 28 Oct 2016 14:02:29 +0900

원문 : https://developers.google.com/identity/sign-in/web/backend-auth

구글플레이 서비스 SDK를 통해서 클라이언트측에서 로그인하고 인증 정보를 서버로 넘겨서 서버측에서 클라이언트의 인증 정보를 검증하는 방법은 아래와 같다.

https://www.googleapis.com/oauth2/v3/tokeninfo?id_token=XYZ123

위주소의 XYZ123부분에 클라이언트가 보내온 액세스 토큰을 넣고 Post또는 Get요청을 보내면 응답을 받을 수 있다.

HTTP 200응답이 수신될경우 JSON포맷의 결과 값을 받게 되고, 대략 아래와 같은 형태이다.

{
 // These six fields are included in all Google ID Tokens.
 "iss": "https://accounts.google.com",
 "sub": "110169484474386276334",
 "azp": "1008719970978-hb24n2dstb40o45d4feuo2ukqmcc6381.apps.googleusercontent.com",
 "aud": "1008719970978-hb24n2dstb40o45d4feuo2ukqmcc6381.apps.googleusercontent.com",
 "iat": "1433978353",
 "exp": "1433981953",

 // These seven fields are only included when the user has granted the "profile" and
 // "email" OAuth scopes to the application.
 "email": "testuser@gmail.com",
 "email_verified": "true",
 "name" : "Test User",
 "picture": "https://lh4.googleusercontent.com/-kYgzyAWpZzJ/ABCDEFGHI/AAAJKLMNOP/tIXL9Ir44LE/s99-c/photo.jpg",
 "given_name": "Test",
 "family_name": "User",
 "locale": "en"
}

이중에서 aud값에 앱의 클라이언트 ID를 담고 있는데 일치 하는지 확인하고 일치한다면,

sub 항목을 유저의 ID로 사용하면된다. sub항목은 구글에서 개인을 식별할 수 있는 유니크 ID이다.

이클립스 c++ 환경구축

래머 — Thu, 27 Oct 2016 11:42:19 +0900

이클립스 사이트에서 c++용 이클립스 다운로드 : Eclipse IDE for C/C++ Developers

http://www.eclipse.org/downloads/eclipse-packages/

현재 최신 버전은 이클립스 네온

이클립스 실행 후 메뉴중

Help -> Install New Software를 선택해서 몇가지 소프트웨어 설치가 필요하다.

해당 메뉴를 선택하면 Install이라는 창이 나온다.

창에서 Work with부분의 콤보박스를 선택해보면 다음과 같은 항목이 있다.

CDT - http://download.eclipse.org/tools/cdt/releases/9.0

위주소는 이클립스 버전에 따라서 다를 수 있음

해당 주소를 선택하면 아래쪽에 체크가 가능한 몇개의 항목이 나온다

CDT Main Features 및 CDT Optional Features를 선택하고 설치를 해준다.

------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

이제 MinGW를 설치해준다.

https://sourceforge.net/projects/mingw/files/

위주소로 가서 설치 파일을 다운로드 후 설치를 진행한다.

설치 프로그램을 실행하면 몇가지 초기설치 단계가 진행되고 이후에 몇개의 설치 가능한 패키지를 선택하는 창이 출력된다.

여기에서 최소 C++컴파일러와 툴킷은 선택하고 설치하도록 한다.

설치 버튼이 따로 있는건 아니고, 메뉴항목중 Installation->Apply Changes를 눌러서 패키지 설치/제거가 가능하다.

시스템 환경변수의 Path에 MinGW의 bin폴더를 추가해준다.

윈도우 컴맨드를 실행해서 gcc를 입력했을때 컴파일러가 실행되면 성공

------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

이제 이클립스에서 컴파일러를 설정해줘야 한다.

이클립스의 메뉴에서

Window -> preferences -> C/C++ -> Build -> Settings -> Discovery항목을 선택한다.

출력되는 창에서 CDT GCC Built-in Compiler Setting[Shcred]를 눌러 COMMAND항목에

-std=c+11 옵션을 뒤쪽에 추가해준다.

------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

이제 이클립스에서 C++프로젝트를 만들고 프로젝트에 C++컴파일러관련 정보를 설정해야한다,.

프로젝트의 프로퍼티창을 오픈한다.

C/C++ Build항목의 Setting를 선택하고 창의 오른쪽에 출력되는 정보중

GCC C++ Compiler-> Dialect 항목을 선택하고 그오른쪽에 다시

Language standard 콤복박스에서 ISO C++11(-std=C++0X)를 선택해준다.

jQuery Event Methods(JQuery 이벤트 메소드들)

래머 — Mon, 14 Mar 2016 15:26:34 +0900

jQuery Event Methods(JQuery 이벤트 메소드들)

« Previous

Next Chapter »

jQuery is tailor-made to respond to events in an HTML page.

JQuery는 HTML페이지의 이벤트들을 수신하는형태로 디지인되었다.

What are Events?(이벤트는 무엇인가?)

All the different visitor's actions that a web page can respond to are called events.

An event represents the precise moment when something happens.

Examples:

웹페이지가 응답할 수 있는 모든 다른 방문자들의 행동들이 이벤트라 불려진다.

이벤트는 특정한 순간에 무언가 일어났다는것을 나타낸다.

예제 :

moving a mouse over an element
selecting a radio button
clicking on an element
요소위에 마우스가 움직임
라디오 버튼이 선택됨
요소가 클릭됨

The term "fires/fired" is often used with events. Example: "The keypress event is fired, the moment you press a key".

Here are some common DOM events:

조건 "fires/fired"는 종종이벤트오 함께 사용된다. 예 : "당신이 키를 누를때 키눌림 이벤트가 발생했다".

다음은 몇가지의 공통적인 DOM이벤트들이다.

Mouse Events	Keyboard Events	Form Events	Document/Window Events
click	keypress	submit	load
dblclick	keydown	change	resize
mouseenter	keyup	focus	scroll
mouseleave		blur	unload

jQuery Syntax For Event Methods(이벤트 메소드들을 위한 JQuery문법)

In jQuery, most DOM events have an equivalent jQuery method.

To assign a click event to all paragraphs on a page, you can do this:

JQuery에서, 대부분의 DOM이벤트들은 동일한 JQuery메소드들을 가진다.

클릭이벤트를 페이지내의 모든 절에 할당하기 위해, 다음과 같이 할 수 있다:

$("p").click();

The next step is to define what should happen when the event fires. You must pass a function to the event:

다음단계는 이벤트가 발생할때 무슨일이 생기는지 정의하는것이다. 당신은 이벤트에 함수를 전달 할 수 있다 :

$("p").click(function(){
  // action goes here!!
});

Commonly Used jQuery Event Methods(공통적으로 사용된 JQuery이벤트 메소드들)

$(document).ready()

The $(document).ready() method allows us to execute a function when the document is fully loaded. This event is already explained in the jQuery Syntax chapter.

$(document).ready() 메소드는 우리에게 문서가 완전히 로드될때 함수가 실행될 수 있게한다. 이 이벤트는 JQuery문법 장에서 이미 설명했다.

click()

The click() method attaches an event handler function to an HTML element.

The function is executed when the user clicks on the HTML element.

The following example says: When a click event fires on a <p> element; hide the current <p> element:

click()메소드는 HTML요소에 이벤트 핸들러 함수를 결합한다.

함수는 사용자가 HTML요소를 클릭할때 실행된다.

다음 예제는 : <p>요소에 클릭이벤트가 발생할때, 현재의 <p>요소를 숨긴다 :

Example

$("p").click(function(){
    $(this).hide();
});

Try it yourself »

dblclick()

The dblclick() method attaches an event handler function to an HTML element.

The function is executed when the user double-clicks on the HTML element:

dblclick() 메소드는 HTML요소에 이벤트 핸들러를 결합한다. 이함수는 HTML요소가 더블클릭될때 실행된다.

Example

$("p").dblclick(function(){
    $(this).hide();
});

Try it yourself »

mouseenter()

The mouseenter() method attaches an event handler function to an HTML element.

The function is executed when the mouse pointer enters the HTML element:

mouseenter() 메소드는 HTML요소에이벤트 핸들러 함수를 결합한다.

함수는 HTML요소에 마우스 포인터가 위치할때 실행된다.

Example

$("#p1").mouseenter(function(){
    alert("You entered p1!");
});

Try it yourself »

mouseleave()

The mouseleave() method attaches an event handler function to an HTML element.

The function is executed when the mouse pointer leaves the HTML element:

mouseleave()메소드는 HTML요소에 이벤트 핸들러를 결합한다.

함수는 HTML요소에 마우스 포인터가 떠날때 실행된다.

Example

$("#p1").mouseleave(function(){
    alert("Bye! You now leave p1!");
});

Try it yourself »

mousedown()

The mousedown() method attaches an event handler function to an HTML element.

The function is executed, when the left, middle or right mouse button is pressed down, while the mouse is over the HTML element:

mousedown() 메소드는 HTML요소에 이벤트 핸들러를 결합한다.

함수는 왼쪽, 중앙, 오른쪽 마우스 버튼이 눌려진상태에서 HTML요소위에 있을때 발생한다.

Example

$("#p1").mousedown(function(){
    alert("Mouse down over p1!");
});

Try it yourself »

mouseup()

The mouseup() method attaches an event handler function to an HTML element.

The function is executed, when the left, middle or right mouse button is released, while the mouse is over the HTML element:

mouseup()는 HTML요소에 이벤트 핸들러를 결합한다. 함수는 마우스의 커서가 HTML요소 위에 있는상태에서 왼쪽, 중앙, 오른쪽 버튼이 눌림해제될때 실행된다.

Example

$("#p1").mouseup(function(){
    alert("Mouse up over p1!");
});

Try it yourself »

hover()

The hover() method takes two functions and is a combination of the mouseenter() and mouseleave() methods.

The first function is executed when the mouse enters the HTML element, and the second function is executed when the mouse leaves the HTML element:

hover() 메소드는 두개의 함수 mouseenter()와 mouseleave()메소드들의 결합형이다.

첫번째 함수는 HTML요소에 마우스가 위치할때 실행되고, 두번째는 마우스가 요소 위에서 떠날때 실행된다:

Example

$("#p1").hover(function(){
    alert("You entered p1!");
},
function(){
    alert("Bye! You now leave p1!");
});

Try it yourself »

focus()

The focus() method attaches an event handler function to an HTML form field.

The function is executed when the form field gets focus:

focus()메소드는 HTML폼 필드에 이벤트 핸들러를 결합한다.

함수는 폼필드가 포커스를 얻을때 실행된다.

Example

$("input").focus(function(){
    $(this).css("background-color", "#cccccc");
});

Try it yourself »

blur()

The blur() method attaches an event handler function to an HTML form field.

The function is executed when the form field loses focus:

blur() 메소드는 HTML폼필드에 이벤트 핸들러를 결합한다.

함수는 폴필드가 포커스를 잃을때 실행된다.

Example

$("input").blur(function(){
    $(this).css("background-color", "#ffffff");
});

Try it yourself »

The on() Method

The on() method attaches one or more event handlers for the selected elements.

Attach a click event to a <p> element:

on()메소드는 선택된 요소들에 하나또는 그이상의 이벤트 핸드러를 결합시킨다.

<p>요소에 클릭이벤트를 결합시키기 :

Example

$("p").on("click", function(){
    $(this).hide();
});

Try it yourself »

Attach multiple event handlers to a <p> element:

<p>요소에 다중 이벤트 핸들러 결합하기:

Example

$("p").on({
    mouseenter: function(){
        $(this).css("background-color", "lightgray");
    }, 
    mouseleave: function(){
        $(this).css("background-color", "lightblue");
    }, 
    click: function(){
        $(this).css("background-color", "yellow");
    } 
});

Try it yourself »

Test Yourself with Exercises!

Exercise 1 » Exercise 2 » Exercise 3 » Exercise 4 » Exercise 5 »

jQuery Selectors(JQuery선택자)

래머 — Mon, 14 Mar 2016 14:55:32 +0900

jQuery Selectors(JQuery 선택자)

« Previous

Next Chapter »

jQuery selectors are one of the most important parts of the jQuery library.

JQuery 선택자들은 JQuery라이브러리의 가장 중요한 부분중 하나이다.

jQuery Selectors

jQuery selectors allow you to select and manipulate HTML element(s).

jQuery selectors are used to "find" (or select) HTML elements based on their id, classes, types, attributes, values of attributes and much more. It's based on the existing CSS Selectors, and in addition, it has some own custom selectors.

All selectors in jQuery start with the dollar sign and parentheses: $().

JQuery선택자들은 당신에게 HTML요소들을 선택하고 조작할 수 있게 한다.

JQuery선택자들은 id, 클래스, 속성, 속성의 값이나 더많은 항목들로부터 HTML요소들을 찾는(또는 선택하는)데 사용된다.

이것은 기존의 CSS 선택자를 기반으로 하며, 추가적으로, 약간의 자체적인 선택자를 가지고 있다.

JQuery의 모든 선택자들은 달러 신호와 괄호로 시작된다 : $()

The element Selector(요소 선택자)

The jQuery element selector selects elements based on the element name.

You can select all <p> elements on a page like this:

JQuery요소 선택자는 요소의 이름에 기반하여 요소를 선택한다.

당신은 페이지모든 <P>요소들을 다음과 같이 선택할 수 있다 :

$("p")

Example(예)

When a user clicks on a button, all <p> elements will be hidden:

유저가 버튼을 클릭할때, 모든 <P>요소들이 숨겨질것이다 :

Example

$(document).ready(function(){
    $("button").click(function(){
        $("p").hide();
    });
});

Try it yourself »

The #id Selector(#id 선택자)

The jQuery #id selector uses the id attribute of an HTML tag to find the specific element.

An id should be unique within a page, so you should use the #id selector when you want to find a single, unique element.

JQuery의 #id선택자는 특정한 요소를 찾기 위해 HTML태그의 id속성을 사용한다.

id는 대개 페이지안에서 유일한것이므로, 당신은 #id선택자를 페이지내에서 유일한 단일요소를 찾기 원할때 사용할 수 있을것이다.

To find an element with a specific id, write a hash character, followed by the id of the HTML element:

특정 ID와 함께 요소를 찾기 위해, 해시문자를 쓰고, 이어서 HTML요소의 ID를 쓴다.

$("#test")

Example(예)

When a user clicks on a button, the element with id="test" will be hidden:

유저가 버튼을 클릭할때, 요소의 id가 "test"인것이 숨겨질것이다.

Example

$(document).ready(function(){
    $("button").click(function(){
        $("#test").hide();
    });
});

Try it yourself »

The .class Selector(.class 선택자)

The jQuery class selector finds elements with a specific class.

To find elements with a specific class, write a period character, followed by the name of the class:

JQuery 클래스 선택자는 특정 클래스이름을 갖는 요소들을 찾는다.

특정클래스를 찾기 위해, 마침표를 쓰고, 이어서 클래스 이름을 적는다.

$(".test")

Example(예)

When a user clicks on a button, the elements with class="test" will be hidden:

유저가 버튼을 클릭ㅎㄹ때, 클래스 이름이 "test"인 요소들을 숨긴다 :

Example

$(document).ready(function(){
    $("button").click(function(){
        $(".test").hide();
    });
});

Try it yourself »

More Examples of jQuery Selectors(JQuery선택자들에 대한 더많은 예제)

Syntax	Description	Example
$("*")	Selects all elements(모든요소선택)	Try it
$(this)	Selects the current HTML element(현재 HTML요소를 선택)	Try it
$("p.intro")	Selects all <p> elements with class="intro"(모든 p요소들중 클래스가 intro인것들 선택)	Try it
$("p:first")	Selects the first <p> element(첫번째 <p>요소 선택)	Try it
$("ul li:first")	Selects the first <li> element of the first <ul>(첫번째 <ul>요소의 첫번째 <li>선택)	Try it
$("ul li:first-child")	Selects the first <li> element of every <ul>(모든 <ul>요소들의 첫번째 <li>선택)	Try it
$("[href]")	Selects all elements with an href attribute(href속성의 요소들 선택)	Try it
$("a[target='_blank']")	Selects all <a> elements with a target attribute value equal to "_blank"(타겟속성이 "_blank"인모든 <a>요소들 선택	Try it
$("a[target!='_blank']")	Selects all <a> elements with a target attribute value NOT equal to "_blank"	Try it
$(":button")	Selects all <button> elements and <input> elements of type="button"	Try it
$("tr:even")	Selects all even <tr> elements	Try it
$("tr:odd")	Selects all odd <tr> elements	Try it

Use our jQuery Selector Tester to demonstrate the different selectors.

For a complete reference of all the jQuery selectors, please go to our jQuery Selectors Reference.

다른 선택자들의 차이점들에 대해 실습해보기 위해 우리의 JQuery선택자 테스터를 사용해라.

JQuery선택자들의 완전한 참조를 위해 우리의 JQuery선택자 참조로 이동하라.

Functions In a Separate File(분리된 파일에서의 함수들)

If your website contains a lot of pages, and you want your jQuery functions to be easy to maintain, you can put your jQuery functions in a separate .js file.

When we demonstrate jQuery in this tutorial, the functions are added directly into the <head> section. However, sometimes it is preferable to place them in a separate file, like this (use the src attribute to refer to the .js file):

만일 당신의 사이트가 많은 페이지들을 담고 있고, 당신이 JQuery 함수들이 쉽게 관리되기를 원한다면, 당신은 JQuery 함수들을 분리된 .js파일에 놓을 수 있다.

우리는 이튜토리얼에서 JQuery실습을 할때, 함수들을 <head>섹션 내부에 추가했었다. 하지만, 때로는 다음과 같이 그것을 분리된 위치에 놓는것이 유용할때가 있다(.js 파일을 참조하기위해 src속성을 사용한다):

Example

<head>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.12.0/jquery.min.js">
</script>
<script src="my_jquery_functions.js"></script>
</head>

jQuery Syntax(Jquery 문법)

래머 — Mon, 14 Mar 2016 14:32:00 +0900

jQuery Syntax(JQuery 문법)

« Previous

Next Chapter »

With jQuery you select (query) HTML elements and perform "actions" on them.

JQuery에서 당신은 HTML요소들을 선택하고 그들에게 액션을 수행한다.

jQuery Syntax

The jQuery syntax is tailor-made for selecting HTML elements and performing some action on the element(s).

Basic syntax is: $(selector).action()

JQuery의 문법은 HTML의 요소를 선택하고 요소로부터 무언가 액션을 수행하는데 맞춰진 형태이다.

기본문법은 다음과 같다 : $(선택자).action()

A $ sign to define/access jQuery
A (selector) to "query (or find)" HTML elements
A jQuery action() to be performed on the element(s)
$는 JQuery에 대한 선언/접근을 위한 신호이다.
(선택자)는 HTML요소를 조회(찾기)위한것이다.
JQuery Action()은 요소에 대한 실행이 될것이다.

Examples(예):

$(this).hide() - hides the current element.(현재 요소를 숨김)

$("p").hide() - hides all <p> elements.(모든 P요소를 숨김)

$(".test").hide() - hides all elements with class="test".(클래스가 "test"인 모든 요소를 숨김)

$("#test").hide() - hides the element with id="test".(id가 "test"인 요소를 숨김)

	Are you familiar with CSS selectors?(CSS 선택자와 유사하다 생각되지 않는가?) jQuery uses CSS syntax to select elements. You will learn more about the selector syntax in the next chapter of this tutorial. JQuery는 요소 선택에 CSS 문법을 사용한다. 튜토리얼의 다음장에서 선택자의 문법에 대해서 배우게 될것이다.

Are you familiar with CSS selectors?(CSS 선택자와 유사하다 생각되지 않는가?)

jQuery uses CSS syntax to select elements. You will learn more about the selector syntax in the next chapter of this tutorial.

JQuery는 요소 선택에 CSS 문법을 사용한다. 튜토리얼의 다음장에서 선택자의 문법에 대해서 배우게 될것이다.

The Document Ready Event(문서 준비됨 이벤트)

You might have noticed that all jQuery methods in our examples, are inside a document ready event:

당신은 우리 예제들의 모든 JQuery메소드들이 document ready 이벤트 내부에 있는것을 볼수 있다.

$(document).ready(function(){

   // jQuery methods go here...

});

This is to prevent any jQuery code from running before the document is finished loading (is ready).

이것은 어떤 JQuery코드가 문서의 로딩이 끝나기(준비되기전) 전에 실행되는것을 피한다.

It is good practice to wait for the document to be fully loaded and ready before working with it. This also allows you to have your JavaScript code before the body of your document, in the head section.

문서가 완전히 로드될떄까지 기다렸다가 무언가 작업을 하는것이 좋다. 이것은 또한 당신의 자바스크립트 코드가 문서의 바디전 헤드부분에 있을수 있게 허용한다.

Here are some examples of actions that can fail if methods are run before the document is fully loaded:

아래에 문서가 완전히 로드되기전에 메소드가 실행될경우 실패하게 되는 액션의 예들이 있다 :

Trying to hide an element that is not created yet
Trying to get the size of an image that is not loaded yet
아직 만들어지지 않은 요소를 숨기려고 시도할경우
아직 로드되지 않은 이미지의 크기를 조회할경우

Tip: The jQuery team has also created an even shorter method for the document ready event:

JQuery팀은 문서 준비됨 이벤트를 위한 더짧은 생성됨 이벤트를 만들어 두었다.

$(function(){

   // jQuery methods go here...

});

Use the syntax you prefer. We think that the document ready event is easier to understand when reading the code.

당신의 마음에 드는 문법을 사용해라. 우리가 생각하기에 문서 준비됨 이벤트를 사용하는게 코드를 읽을때 더이해하기 쉬운것같다.

JQuery 시작하기

래머 — Fri, 11 Mar 2016 12:28:29 +0900

jQuery Get Started(JQuery 시작하기)

« Previous

Next Chapter »

Adding jQuery to Your Web Pages(JQuery를 당신의 웹사이트에추가하기)

There are several ways to start using jQuery on your web site. You can:

당신의 웹사이트에서 JQuery를 사용하기위한 다음의 몇가지 방법들이 있다:

Download the jQuery library from jQuery.com(JQuery.com으로부터 JQuery라이브러리 다운로드하기)
Include jQuery from a CDN, like Google(구글의 CDN 같은곳을 통해 JQuery를 포함시키기)

Downloading jQuery(JQuery다운로드하기)

There are two versions of jQuery available for downloading:

다운로드 가능한 두가지 버전의 JQuery라이브러리가 있다:

Production version - this is for your live website because it has been minified and compressed
상용버전 - 이버전은 축소되고 압축되었기 때문에 당신의 라이브 웹사이트를 위한것이다.
Development version - this is for testing and development (uncompressed and readable code)
개발버전 - 이것은 테스트 및 개발을 위한 버전이다(압축되지 않았고 읽기 가능한 코드이다)

Both versions can be downloaded from jQuery.com.

두 버전들은 JQuery.com으로부터 다운로드 할 수 있다.

The jQuery library is a single JavaScript file, and you reference it with the HTML <script> tag (notice that the <script> tag should be inside the <head> section):

JQuery라이브러리는 단일의 자바스크립트 파일이며, HTML <script> 태그를 통해서 참조할 수 있다(주의할것은 <script>태그는 <head> 섹션내부에 포함되어야 할것이다)

<head>
<script src="jquery-1.12.0.min.js"></script>
</head>

Tip: Place the downloaded file in the same directory as the pages where you wish to use it.

팁 : 당신이 사용할 장소와 같은 디렉토리에 다운로드될 파일을 위치시켜라

	Do you wonder why we do not have type="text/javascript" inside the <script> tag? type="text/javascript"속성을 <script>태그 내부에 왜가지고 있지 않은지 놀랍지 않은가? This is not required in HTML5. JavaScript is the default scripting language in HTML5 and in all modern browsers! 이것은 HTML5에서 요구되지 않기 때문이다. 자바스크립트는 HTML5와 현대의 모든 브라우저들에서 기본스크립트 언어이다.

Do you wonder why we do not have type="text/javascript" inside the <script> tag?
type="text/javascript"속성을 <script>태그 내부에 왜가지고 있지 않은지 놀랍지 않은가?

This is not required in HTML5. JavaScript is the default scripting language in HTML5 and in all modern browsers!

이것은 HTML5에서 요구되지 않기 때문이다. 자바스크립트는 HTML5와 현대의 모든 브라우저들에서 기본스크립트 언어이다.

jQuery CDN

If you don't want to download and host jQuery yourself, you can include it from a CDN (Content Delivery Network).

Both Google and Microsoft host jQuery.

만일 자체적으로 JQuery를 호스트하는 형태로 다운로드되기를 원하지 않는다면, 그것을 구글이나 마이크로소프트가 호스트하는 JQuery의 CDN으로 부터 포함시킬 수 있다.

To use jQuery from Google or Microsoft, use one of the following:

구글이나 마이크로소프트로부터 JQuery를 이용하기위해 다음의 하나를 사용한다:

Google CDN:

<head>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.12.0/jquery.min.js"></script>
</head>

Try it yourself »

Microsoft CDN:

<head>
<script src="http://ajax.aspnetcdn.com/ajax/jQuery/jquery-1.12.0.min.js"></script>
</head>

Try it yourself »

	One big advantage of using the hosted jQuery from Google or Microsoft: 구글 또는 마이크로소프트의 호스트를 이용하는것에 대한 하나의 큰 장점: Many users already have downloaded jQuery from Google or Microsoft when visiting another site. As a result, it will be loaded from cache when they visit your site, which leads to faster loading time. Also, most CDN's will make sure that once a user requests a file from it, it will be served from the server closest to them, which also leads to faster loading time. 많은 사용자들은 다른 하나의 사이트를 방문할때 구글이나 마이크로소프트로부터 다운로드된 JQuery를 이미 가지고 있게된다. 결과적으로, 그들이 당신의 사이트를 방문할때 그것은 캐시로부터 로드되고, 이것은 로딩 시간을 빠르게한다. 또한, 대부분의 CDN들은 일단 유저들로부터 파일이 요청되면, 그들로부터 가장가까운 서버로 부터 그것을 제공할것이고, 이것은 로딩시간을 빠르게 하게된다.

One big advantage of using the hosted jQuery from Google or Microsoft:
구글 또는 마이크로소프트의 호스트를 이용하는것에 대한 하나의 큰 장점:

Many users already have downloaded jQuery from Google or Microsoft when visiting another site. As a result, it will be loaded from cache when they visit your site, which leads to faster loading time. Also, most CDN's will make sure that once a user requests a file from it, it will be served from the server closest to them, which also leads to faster loading time.
많은 사용자들은 다른 하나의 사이트를 방문할때 구글이나 마이크로소프트로부터 다운로드된 JQuery를 이미 가지고 있게된다. 결과적으로, 그들이 당신의 사이트를 방문할때 그것은 캐시로부터 로드되고,

이것은 로딩 시간을 빠르게한다. 또한, 대부분의 CDN들은 일단 유저들로부터 파일이 요청되면, 그들로부터 가장가까운 서버로 부터 그것을 제공할것이고, 이것은 로딩시간을 빠르게 하게된다.

JQuery 소개

래머 — Fri, 11 Mar 2016 12:06:19 +0900

JQuery Introduction(JQuery소개)

« Previous

Next Chapter »

The purpose of jQuery is to make it much easier to use JavaScript on your website.

JQuery의 목적은 당신의 웹사이트에서 자바스크립트를 매우 쉽게 사용하도록 만드는것이다.

What You Should Already Know(당신은 먼저 어떤것들에 대해서 알아야 하는가?)

Before you start studying jQuery, you should have a basic knowledge of:

JQuery를 배우기전에, 당신은 다음에 대한 기본지식이 필요할것이다.

HTML
CSS
JavaScript

-HTML

-CSS

-JavaScript

If you want to study these subjects first, find the tutorials on our Home page.

만일 당신이 이 주제들을 먼저 배우기 원한다면 우리의 웹사이트에서 튜토리얼을찾을 수 있다.

What is jQuery?(JQuery는 무엇인가?)

jQuery is a lightweight, "write less, do more", JavaScript library.

JQuery는 가볍고, "적게 쓰고, 많은것을 하는" 자바스크립트 라이브러리다.

The purpose of jQuery is to make it much easier to use JavaScript on your website.

Jqeury의 목적은 당신의 웹사이트에서 자비스크립트 사용을 쉽게 만드는 것이다.

jQuery takes a lot of common tasks that require many lines of JavaScript code to accomplish, and wraps them into methods that you can call with a single line of code.

JQuery는 구현을 위해 매우 많은 자바스크립트 코드 라인을 요구하는 공통적인 작업을 처리하며, 이러한 방법들을 단일라인의 코드호출로 수행할 수 있게 감싸고 있다.

jQuery also simplifies a lot of the complicated things from JavaScript, like AJAX calls and DOM manipulation.

JQuery는 또한 ASAX나 DOM조작과 같이 자바스크립트에 매우 복잡하게 얽힌것들을 단순화 시킨다.

The jQuery library contains the following features:

JQuery라이브러리는 다음의 기능들을 담고 있다:

HTML/DOM manipulation(HTML/DOM 조작)
CSS manipulation(CSS 조작)
HTML event methods(HTML 이벤트 메소드들)
Effects and animations(이팩트와 애니메이션들)
AJAX
Utilities(유틸리티들)

Tip: In addition, jQuery has plugins for almost any task out there.

추가적으로, JQuery는 그것 외에 임의의 작업을 위한 거의 모든 플러그인들을 가지고 있다.

Why jQuery?(왜 JQuery인가?)

There are lots of other JavaScript frameworks out there, but jQuery seems to be the most popular, and also the most extendable.

세상에는 수많은 자바스크립트 프레임워크들이 있다, 그러나 JQuery는 가장 대중적이며, 가장 확장성있는것으로 보여진다.

Many of the biggest companies on the Web use jQuery, such as:

다음과 같은 많은 거대 회사들이 웹사이트에서 JQuery를 사용하고 있다:

Google
Microsoft
IBM
Netflix

	Will jQuery work in all browsers?(JQuery는 모든 브러우저들에서 작동하는가?) The jQuery team knows all about cross-browser issues, and they have written this knowledge into the jQuery library. jQuery will run exactly the same in all major browsers, including Internet Explorer 6! JQuery팀은 크로스 브라우저 이슈들에 대한 모든것들을 알 고 있고, 이러한 지식들은 JQuery라이브러리에 쓰여졌다. JQuery는 인터넷 익스플러러 6를 포함하여 모든 메이저 브라우저들에서 완벽히 동일하게 실행될것이다!

Will jQuery work in all browsers?(JQuery는 모든 브러우저들에서 작동하는가?)

The jQuery team knows all about cross-browser issues, and they have written this knowledge into the jQuery library. jQuery will run exactly the same in all major browsers, including Internet Explorer 6!
JQuery팀은 크로스 브라우저 이슈들에 대한 모든것들을 알 고 있고, 이러한 지식들은 JQuery라이브러리에 쓰여졌다. JQuery는 인터넷 익스플러러 6를 포함하여 모든 메이저 브라우저들에서 완벽히 동일하게 실행될것이다!

골드 스푼 메이커 게임 소개

래머 — Thu, 7 Jan 2016 23:20:42 +0900

모바일 게임 골드스푼메이커입니다.

유니티5 버전으로 제작했으며, 현재도 서비스중입니다.

원래 구글, 애플, 네이버등에도 서비스 했지만 현재는 앱스토어, 원스토어에만 출시된상태입니다.

서버없는 게임이며, 쿠폰사용 기능과 관련해서 JSP기반 웹서버를 이용중입니다.

전체 프로그램 파트를 맡았습니다.

아래는 WEBGL버전으로 컨버팅한것입니다.

아무것도 표시되지 않는다면 브라우저에 의해서 클라이언트가 차단된경우일 수 있습니다.

안전하지 않은 스크립트소스 로드 허용하시면 플레이 가능합니다.

애플 스토어에서 다운로드

원스토어에서 다운로드

밸런싱로봇 종합사항

래머 — Mon, 21 Dec 2015 13:11:13 +0900

일단 아래 소스를 다운로드 해주세요. 라이브러리 없이 밸런싱 로봇 소스만 포함한 소스입니다. pid쪽으로 약간의 수정이 된 버전입니다.

아두이노스케치용소스.zip

가장처음으로 모터드라이버와 아두이노의 회로배선상태되도 소스를 수정합니다.

아래 사진에 보이는 부분입니다.

두번째는 센서와 차체의 방향에 따라서 각도를 읽어 오는 부분을 수정합니다. 바퀴축과 나란한 축이 X축이면 아래와 같이 m_Gyro.GetKalAngleX()를통해서 x축 각도를 읽도록하고 Y축이라면 m_Gyro.GetKalAngleY()를 통해서 Y축각도를 읽도록 합니다.

소스를 업로드 하고 밸런싱로봇 작동상태를 확인합니다.

만일 바퀴가 움직이지 않으면, 아두이노와 모터드라이버의 핀연결 상태가 소스에서 설정한 핀과 일치하는지 확인합니다.

배선상태와 핀설정이 일치한다면, 테스터기 같은것으로 모터드라이버의 출력측을 측정해서 출력이 있는지 확인합니다. 출력이 있고, 차체의 기울어짐에 따라서 출력전압 극성에 변동이 있다면 일단 소스와 회로 구성은 올바르지만, 모터를 구동시킬만큼 출력전류가 충분하지 않아서 그러것입니다.

이때는 아래소스에 보이는 것처럼 PID_SCALE을 높여 보시기 바랍니다. 모터가 움직일때까지 해당값을 조금씩 높여가면서 테스트 해봅니다.

저부분은 원래 소스에는 없던 부분입니다. 새로 추가한 부분인데,

소스상에도 설명되어 있지만, 제공된 소스는 제가 만든 밸런싱 로봇에 맞게 PID설정이 되어 있습니다. 밸런싱로봇의 무게나, 무게중심, 모터특성등에 따라서 적절한 PID값을 조정해야 합니다. 최적의 PID값을 찾아내지 못하면 밸런싱 로봇의 중심잡기는 실패 하게 됩니다.

PID_SCALE조정으로 바퀴가 움직이고, 기울어짐에 따라 회전 방향이 정상적으로 바뀐다면 30%정도는 성공한것입니다.

만일 기울어진 방향과 반대 방향으로 모터가 움직인다면 반대로 움직이는 쪽 부분만 http://eltgroup.tistory.com/299 글을 참고해서 코드를 수정합니다

이제남은 일은 최적의 PID값을 찾는 일입니다. 밸런싱로봇을만들때 가장 힘든부분입니다. 운이좋아 PID_SCALE값 조정만으로 밸런스가 유지된다면 따로 PID값 조정할 필요는 없습니다.

위소스에 보이는것처럼, PID_KP, PID_KI, PID_KD 값을 자신의 차체에 맞는 값으로 찾아서 수정해야 합니다.

동역학이론을 동원해서 실험과 특성을 추출해서 계산해내지 않는이상은, 3가지 값을 조금씩 바꿔가면서 차체가 밸런스를 잡을때까지 무한 수정 노가다를 할 수 밖에 없습니다.

밸런싱로놋 mpu6050 센서방향

래머 — Sat, 19 Dec 2015 21:58:16 +0900

위사진에 보이는것처럼 센서의 y축이 차체의 바퀴와 나란히 배치되어 있습니다.

센서의 Y각도를 추출해서 밸런싱에 이용하고 있습니다.

아래는 올리신 사진인데, 사진이 흐려 자세히 보이지는 않지만 센서의 x축이 바퀴축과 나란한것 같습니다.

위사진에 보면 mpu6050의 int핀에 선이 연결되어 있는것 같습니다. 해당 핀에 LOW, HIGH신호를 가하는것에 따라서 mpu6050 i2c통신 주소가 달라집니다.

일단 소스코드상에서는 해당 핀에 아무것도 연결하지 않은 상태의 주소로 설정되어 있으니, 해당 핀에 연결된 선은 빼주시기 바랍니다.

그리고 소스코드상에서는y축의 각도 변화를 추출하는데, 위의 차체에서는 차체가 기울더라도 x축을 중심으로 기울기에 변화가 있기 때문에, 올바르지 않게 작동하게 될겁니다.

두가지 방법이 있는데, 한가지는 첫번째사진과 같이 축을 일치 시켜주는 방법이고, 다른 방법은 소스코드상에서

Y축 기울기를 측정하는 부분을 x축 기울기 측정으로 바꾸는 겁니다. 두번째가 더간단할거 같네요.

기울기를 측정하는 부분은 소스코드상에서 아래부분과 같습니다.

CSelfBlancer.h 파일의 내부에 보시면 Update() 함수가 있습니다.

붉은원으로 표시해놓은 부분에 보시면 원래는 저부분이

m_Gyro.GetKalAngleY() 라고 되어 있습니다. 이것을 아래 그림에 나온것처럼 m_Gyro.GetKalAngleX()라고 바꿔주시면됩니다.

위와같이 수정하시고, 업로드 하신다음에 정상적이라면 바퀴축을 기준으로 차체를 기울일경우 기울인방향으로 모터가 회전해야 합니다.

만일 기울인 반대 방향으로 모터가 회전한다면, 정방향/역방향이 바뀐경우이니

그때는 단순하게 모터드라이버에 연결된 선을 서로 바꿔서 연결하거나 아니면 아래와 같이 소스코드 부분을 수정하시면됩니다.

역시 같은 소스인 CSelfBlancer.h 파일을 열어서

아래 사진에 표시 해놓은 부분을 수정하시면 되는데

g_Motor.Backward 부분과 g_Motor.Forward 부분을 서로 바꿔주시면 됩니다.

그러니까 아래 그림의 UpdateLeft함수와 UpdateRight함수 내부에 보시면

g_Motor.Backward 부분과 g_Motor.Forward가 있는데

g_Motor.Backward(true, (uint8_t)(-fControl)); 를 g_Motor.Forward(true, (uint8_t)(-fControl)); 로바꾸고

g_Motor.Forward(true, (uint8_t)fControl); 는 g_Motor.Backward(true, (uint8_t)fControl); 처럼

Backward와 Forward를 서로 바꾸면 됩니다.

밸런싱로봇 전력공급

래머 — Fri, 11 Dec 2015 20:55:10 +0900

위에 사진을 보시는 것처럼 2종의 배터리 전원공급부가 보입니다. 9V충전지는 아두이노 자체에 전력을 공급하기 위한 용도입니다. 충전건전지는 모터드라이버에 전원을 공급하기 위한 용도입니다. 9V전지와 건전지 4개는 Gnd를 공유하고 있습니다.

각 모터마다 필요로 하는 전류 및 전압의 크기가 있습니다. 모터의 정격전류 및 전압인데 충분히 공급되지 못하면 모터는 움직이지 않게 될겁니다.

보여주신 연결상으로 별다른 문제는 보이지 않는듯합니다. 제공한 소스또한 제가 직접 테스트를 해서 문제가 없다는 것을 확인했기 때문에 핀연결이 올바르게 되었다면 모터가 작동해야 하는게 정상입니다.

자세한 내용은 모르겠지만 9V건전지 만으로 전원을 공급하시는경우라면 전력부족으로 모터가 가동되지 않을 수 있습니다. 모터가 움직이기에 충분한 전력을 공급하셔야 합니다. 참고로 일반 알카라인 건전지의 경우 공급가능한 전류의 양이 너무적기 때문에 사용하시는 모터를 구동하기에 부족할 가능성이 높습니다.

충전지 계열을 이용하시는게 좋을겁니다.

아래는 소스를 업로드 했을때 밸런싱 로봇의 상태입니다.

보시는 것처럼 바로 작동이 되야 합니다. (댓글에도 달았지만, 기존에 제가 작성해둔 소스에서 LED컨트롤을 위해서 두개의 핀 9, 10번을 사용하고 있었습니다. 만드신 밸런스 로봇이 사용하는것과 중복되게핀을 사용중이라 제대로 작동이 안될 수 있을것 같은데, 일단 LED제어하는 부분을 비활성화한 소스를 업로드 해놨습니다. 해당 소스를 사용하시면될것 같습니다.)

밸런싱 로봇 소스 사용법

래머 — Mon, 7 Dec 2015 20:54:44 +0900

일단 여기에서 소스를 다운로드 합니다.

소스다운로드(Git)

압축을 푸시면 아래와 같은 내용물들이 보일겁니다.

Libraries폴더에는 아두이노용 라이브러리들이 들어 있습니다.

비주얼스튜디오용소스에는 비주얼스튜디어용 밸런싱 로봇소스가 있습니다.

아두이노스케치용소스에는 순수 아두이노 스케치용 소스가 들어 있습니다.

일단 Libraries폴더를 보면 아래와 같은 내용물들이 보입니다.

폴더가 몇개 보이는데요, 3개의 폴더들을 아두이노스케치 프로그램의 라이브러리 폴더에 복사해 넣어야 합니다.

아두이노 아이콘에서 오른버튼 클릭하시고 속성에 들어가시면 아두이노 스케치 설치위치로 이동할 수 있습니다.

폴더내용물을 보시면 아래에 보이는것처럼 libraries폴더가 보일겁니다. 저기 안에 밸런싱로봇 소스의 Libraries폴더안에 있던 3개 폴더를 복사해 넣으면 됩니다.

아래 그림처럼 3개의 폴더를 복사해 넣습니다.

이제 라이브러리 설치는 끝났습니다. 아두이노 스케치 프로그램을 실행중이라면 일단 종료를 해주세요.

밸런싱 로봇 소스로 다시 돌아와서 아두이노용 소스 폴더로 들어가보면

아래와 같은 파일들이 보일겁니다.

저기위에 표시해놓은 Blancer.ino파일을 아두이노 스케치 프로그램으로 열어주시면 됩니다.

소스를 보시면 다음과 같은 부분이 있을겁니다.

CDCMotorDriver는 모터드라이버를 제어하기위해 만든클래스 입니다. 생성자의 인자로 핀번호를 받고 있는데요

입력인자순서되로

모터1핀1, 모터1핀2, 모터2핀1, 모터2핀2, 모터1PWM핀, 모터2PWM핀

입니다.

이6개의 핀번호를 구성하신 회로와 맞게 수정하신다음에 아두이노에 업로드 하시고 사용하시면됩니다.

소스에 첨부된 설명.xlxs파일에보시면 간략한 설명이 포함되어 있습니다.

읽어 보시면될것 같습니다.

툼레이더 애니버서리 플레이 영상 41 ~ 45

래머 — Mon, 16 Nov 2015 04:16:31 +0900

툼레이더 애니버서리 플레이 영상 41

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 42

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 43

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 44

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 45

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 31 ~ 40

래머 — Mon, 16 Nov 2015 04:07:38 +0900

툼레이더 애니버서리 플레이 영상 31

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 32

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 33

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 34

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 35

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 36

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 37

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 38

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 39

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 40

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 21 ~ 30

래머 — Mon, 16 Nov 2015 03:51:15 +0900

툼레이더 애니버서리 플레이 영상 21

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 22

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 23

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 24

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 25

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 26

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 27

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 28

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 29

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 30

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 11 ~ 20

래머 — Mon, 16 Nov 2015 03:33:26 +0900

툼레이더 애니버서리 플레이 영상 11

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 12

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 13

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 14

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 15

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 16

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 17

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 18

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 19

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 20

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 1 ~ 10

래머 — Mon, 16 Nov 2015 03:17:30 +0900

툼레이더 애니버서리 플레이 영상 1

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 2

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 3

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 4

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 5

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 6

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 7

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 8

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 9

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 애니버서리 플레이 영상 10

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 31 ~ 40

래머 — Mon, 16 Nov 2015 03:07:52 +0900

툼레이더 언더월드 플레이 영상 31

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 32

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 33

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 34

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 35

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 36

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 37

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 38

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 39

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 40

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 21 ~ 30

래머 — Mon, 16 Nov 2015 02:52:08 +0900

툼레이더 언더월드 플레이 영상 21

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 22

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 23

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 24

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 25

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 26

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 27

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 28

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 29

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 30

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 11 ~ 20

래머 — Mon, 16 Nov 2015 02:32:07 +0900

툼레이더 언더월드 플레이 영상 11

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 12

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 13

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 14

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 15

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 16

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 17

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 18

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 19

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 20

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 1 ~ 10

래머 — Mon, 16 Nov 2015 01:53:08 +0900

툼레이더 언더월드 플레이 영상1

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 2

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상 3

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상4

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상5

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상6

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상7

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상8

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상9

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 언더월드 플레이 영상10

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

툼레이더 레전드 플레이영상

래머 — Sun, 15 Nov 2015 15:54:05 +0900

플레이1

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

플레이2

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

플레이3

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

플레이4

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

플레이5

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

플레이6

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

플레이7

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

플레이8

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

플레이9

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

플레이10

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

플레이11

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

플레이12

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

플레이13

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

플레이14

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

플레이15

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

플레이16

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

플레이17

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

플레이18

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

플레이19

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

플레이20

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

플레이21

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

플레이22

동영상 서비스가 종료되어 해당 콘텐츠를 재생할 수 없습니다.

파일질라 FTP 서버구축하기

래머 — Tue, 10 Nov 2015 06:17:09 +0900

업무상 FTP서버를 자주 사용합니다.

몇개의 FTP서버를 이용해 봤지만 파일질라서버가 가장 단순하고 파워풀한것 같습니다.

아래는 파일질라 FTP서버를 구축하는 방법에 대해서 설명해봤습니다.

먼저 FTP서버 설치 파일을 다운로드 받습니다.

공식적인 경로를 통해서 받으셔도 되지만 버전이 다를 수 있어 설명에 차이가 있을 수 있습니다.

파일질라설치파일

파일질라서버.zip

다운로드 받은 파일을 적당한 곳에 압축을 풉니다. 내용물을 보시면 아래와 같습니다.

FileZilla_Server-0_9_41.exe 가 서버 설치파일입니다. 위에 있는 FileZilla_server.exe는 서버 실행파일인데 유니코드 관련 패치가 되어 있는 버전입니다. 나중에 FTP서버에서 한글을 지원하기 위해서 필요합니다.

일단 설치 파일을 설치 합니다.

설치 과정은 그냥 Next를 주구장창 해주시면 됩니다.

서버 설치가 완료되었다면 FTP서비스가 자동으로 시작되게 됩니다. 유니코드 패치된 버전으로 교체하기 위해서 서비스를 멈추어야 합니다.

아래 그림에 보여지는 것처럼 프로그램 그룹으로 가서 Stop FileZilla Server를 통해서 서버를 멈출 수 있습니다.

만일 저방법으로 서버가 멈춰지지 않으면 직접 서비스항목에서 멈출 수 있습니다.

이제 파일질라서버가 설치된 폴더로 가서 아까 위에 압축풀었던 FileZilla_server.exe 파일을 덮어쓰기 해줍니다.

그런다음 다시 파일질라 서버를 재가동 합니다. 파일그룹에서 Start Filezilla Server로 재가동하시거나 아래 그림처럼 서비스에서 직접 가동할 수 있습니다.

윈도우 트레이 영역에 보시면 아래 그림에 표시해놓은것처럼 서버 인터페이스 아이콘이 보입니다. 더블 클릭해서 파일질라 서버 인터페이스를 오픈 합니다.

파일질라 서버 인터페이스의 모습입니다.

매우 단촐한 구성이네요.

FTP클라이언트가 서버에 접속하기 위해서 계정이 필요합니다.

계정등록을 해보겠습니다.

아래 그림에 표시해놓은 사람모양 아이콘을 눌러줍니다.

그럼 아래 그림처럼 UI가 오픈되는데요.

오른쪽에 보시면 Users라고 등록된 계정의 목록이 나옵니다.

아래에 Add버튼을 눌러서 새로운 계정을 추가 할 수 있습니다.

Add버튼을 누르면 아래 그림처림 계정등록창이 나오는데 입력영역에 ID를 입력하시고 OK를 눌러줍니다.

계정이 추가 되었습니다. Users목록에 새로 추가된 계정(test)가 보이네요.

test를 선택하시고 왼쪽의 General항목을 눌러 줍니다.

몇개의 체크박스와 입력박스가 있는데

계정에 비번을 적용하실거면 Password항목에 체크를 해주시고 바로 오른편의 입력박스에 비번을 입력해줍니다.

다음으로 해당 FTP계정이 사용할 폴더를 지정해줘야 합니다.

왼쪽 Page영역의 Shared folders 를 눌러 보시면 아래 그림과 같은 모습을 볼 수 있습니다.

그림에 표시해놓은 Add버튼을 눌러서 공유 폴더를 추가 할 수 있습니다.

사용하실 폴더를 선택하고 확인을 해주세요.

선택한 폴더가 추가된 것을 볼 수 있습니다.

표시해놓은 files영역을 보시면 여러개의 체크 박스가 있는걸 볼 수 있습니다.

Shares folders에 있는 폴더를 선택하고 해당 폴더에 대한 권한을 지정할 수 있는 기능입니다.

Read, Write는 파일 읽기 및 쓰기 가능

Delete는 파일 지우기 가능

Append 는 파일 수정가능

디렉토리 항목에 있는

Create, Delete는 디렉토리(폴더) 생성 삭제 가능

List는 디렉토리 조회가능

+Subdirs는 디렉토리의 하위디렉토리까지 조회가능

하다는 의미입니다.

적절한 권한을 선택해주시고 OK버튼을 눌러주시면 됩니다.

설정이 성공적이라면 아래 그림과 같은 메시지를 볼 수 있습니다.

기본적으로 FTP서버는 21번 22번 포트를 사용하고 있습니다. 하지만 보안을 생각한다면 포트를 변경해주시는게 좋겠습니다.

툴바영역의 톱니 모양 아이콘을 눌러서 서버 옵션설정창에 진입할 수 있습니다.

옵션 설정창의 모습입니다.

가장위의 제너럴 셋팅 항목을 선택하시고 Listen On these ports에 원하시는 적당한 포트명을 기입합니다.

1 ~ 65535까지 입력가능하네요. OK를 눌러 주시면 옵션 변경이 완료됩니다.

이로서 서버에 대한 설정은 마무리 되었습니다. 더많은 기능들이 있는데 위정도까지만 설정하셔도 사용하는데 별다른 불편은 없을 겁니다.

이제 테스트를 해볼차례입니다.

아래 그림은 FTP클라이언트로 유명한 파일질라 FTP클라이언트의 모습입니다.

다양한 경로를 통해서 다운로드 할 수 있으니 검색을 통해서 다운로드 받으시기 바랍니다.

설치하고 실행하시면 아래 그림과 같은 화면을 볼 수 있습니다.

상단의 툴바 영역에 호스트, 사용자면, 비밀번호, 포트등을 입력할 수 있는 공간이 보입니다.

호스트에는 FTP서버의 주소를 입력해줍니다.

사용자명과 비밀번호에는 아까 위에서 만들었던 계정을 입력해주시면 도고

포트는 역시 위에서 설정한 포트를 입력 후 빠른 연결 버튼을 눌러 서버에 접속 할 수 있습니다.

아래는 서버 접속에 성공한 모습입니다.

그림에 보시면 빈디렉터리 목록이라는 영역이 보일겁니다. 위의 계정에서 설정한 공유폴더의 내용물이 표시되는 공간입니다.

여기에 파일을 업로드 하시거나 다운로드 할 수 있습니다.

이상 간단한 설명을 마칩니다.

구글플레이 게임서비스 클라우드 저장 사용하기(Googleplay game service cloud saving)

래머 — Fri, 30 Oct 2015 09:50:39 +0900

구글플레이 서비스에서 유용한점 하나가 클라우드 저장기능입니다.

서버가 없는 게임인경우 게임데이터를 구글클라우드 서버에 저장하거나 가져오기를 통해서 사용자의 데이터를 안전하게 보관할 수 있습니다.

아래 주소에서 유니티용 플러그인을 다운로드 할 수 있습니다.

https://github.com/playgameservices/play-games-plugin-for-unity

구글플레이 게임서비스 이용에 관한 전반적인 사항은 검색을 통해서 확인하시기 바랍니다.

클라우드 저장기능사용에 대한 핵심적인 부분만 코드로 보여드립니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
 
using UnityEngine;
using System.Collections;
using GooglePlayGames;
using GooglePlayGames.BasicApi;
using GooglePlayGames.BasicApi.SavedGame;
 
public static class CGoogleplayGameServiceManager
{
    //게임서비스 플러그인 초기화시에 EnableSavedGames()를 넣어서 저장된 게임 사용할 수 있게 합니다.
    //주의 하실점은 구글플레이 개발자 콘솔의 게임서비스에서 해당게임의 세부정보에서 저장된 게임 사용을 
    //하도록 설정하셔야 합니다.
    public static void Init()
    {
        PlayGamesClientConfiguration config = new PlayGamesClientConfiguration.Builder().EnableSavedGames().Build();
 
        PlayGamesPlatform.InitializeInstance(config);
 
        //
        PlayGamesPlatform.DebugLogEnabled = false;
 
        //Activate the Google Play gaems platform
 
        PlayGamesPlatform.Activate();
    }
 
    //인증여부 확인
    public static bool CheckLogin()
    {
        return Social.localUser.authenticated;
    }
    //--------------------------------------------------------------------
    //게임 저장은 다음과 같이 합니다.
    public static void SaveToCloud()
    {
        if (!CheckLogin()) //로그인되지 않았으면
        {
            //로그인루틴을 진행하던지 합니다.
            return;
        }
 
        //파일이름에 적당히 사용하실 파일이름을 지정해줍니다.
        OpenSavedGame("사용할파일이름", true);
    }
 
    static void OpenSavedGame(string filename, bool bSave)
    {
        ISavedGameClient savedGameClient = PlayGamesPlatform.Instance.SavedGame;
 
        if (bSave)
            savedGameClient.OpenWithAutomaticConflictResolution(filename, DataSource.ReadCacheOrNetwork, ConflictResolutionStrategy.UseLongestPlaytime, OnSavedGameOpenedToSave); //저장루틴진행
        else
            savedGameClient.OpenWithAutomaticConflictResolution(filename, DataSource.ReadCacheOrNetwork, ConflictResolutionStrategy.UseLongestPlaytime, OnSavedGameOpenedToRead); //로딩루틴 진행
    }
 
 
    //savedGameClient.OpenWithAutomaticConflictResolution호출시 아래 함수를 콜백으로 지정했습니다. 준비된경우 자동으로 호출될겁니다.
        static void OnSavedGameOpenedToSave(SavedGameRequestStatus status, ISavedGameMetadata game)
        {
            if (status == SavedGameRequestStatus.Success)
        {
            // handle reading or writing of saved game.
 
                //파일이 준비되었습니다. 실제 게임 저장을 수행합니다.
                //저장할데이터바이트배열에 저장하실 데이터의 바이트 배열을 지정합니다.
                SaveGame(game, "저장할데이터바이트배열", DateTime.Now.TimeOfDay);
        }
        else
        {
            //파일열기에 실패 했습니다. 오류메시지를 출력하든지 합니다.
        }
    }
 
    static void SaveGame(ISavedGameMetadata game, byte[] savedData, TimeSpan totalPlaytime)
    {
        ISavedGameClient savedGameClient = PlayGamesPlatform.Instance.SavedGame;
 
        SavedGameMetadataUpdate.Builder builder = new SavedGameMetadataUpdate.Builder();
        builder = builder
            .WithUpdatedPlayedTime(totalPlaytime)
            .WithUpdatedDescription("Saved game at " + DateTime.Now);
 
        /*
        if (savedImage != null)
        {
            // This assumes that savedImage is an instance of Texture2D
            // and that you have already called a function equivalent to
            // getScreenshot() to set savedImage
            // NOTE: see sample definition of getScreenshot() method below
            byte[] pngData = savedImage.EncodeToPNG();
            builder = builder.WithUpdatedPngCoverImage(pngData);
        }*/
 
        SavedGameMetadataUpdate updatedMetadata = builder.Build();
        savedGameClient.CommitUpdate(game, updatedMetadata, savedData, OnSavedGameWritten);
    }
 
    static void OnSavedGameWritten(SavedGameRequestStatus status, ISavedGameMetadata game)
    {
        ShowActionBar(false, true);
 
        if (status == SavedGameRequestStatus.Success)
        {
            //데이터 저장이 완료되었습니다.
        }
        else
        {
            //데이터 저장에 실패 했습니다.
        }
    }
 
    //----------------------------------------------------------------------------------------------------------------
    //클라우드로 부터 파일읽기
    public static void LoadFromCloud()
    {
        if (!CheckLogin())
        {
            //로그인되지 않았으니 로그인 루틴을 진행하던지 합니다.
            return;
        }
 
        //내가 사용할 파일이름을 지정해줍니다. 그냥 컴퓨터상의 파일과 똑같다 생각하시면됩니다.
        OpenSavedGame("사용할파일이름", false);
    }
 
 
    static void OnSavedGameOpenedToRead(SavedGameRequestStatus status, ISavedGameMetadata game)
    {
        if (status == SavedGameRequestStatus.Success)
        {
            // handle reading or writing of saved game.
            LoadGameData(game);
        }
        else
        {
            //파일열기에 실패 한경우, 오류메시지를 출력하던지 합니다.
        }
    }
 
    //데이터 읽기를 시도합니다.
    static void LoadGameData(ISavedGameMetadata game)
    {
        ISavedGameClient savedGameClient = PlayGamesPlatform.Instance.SavedGame;
        savedGameClient.ReadBinaryData(game, OnSavedGameDataRead);
    }
 
    static void OnSavedGameDataRead(SavedGameRequestStatus status, byte[] data)
    {
            if (status == SavedGameRequestStatus.Success)
            {
                // handle processing the byte array data
 
                //데이터 읽기에 성공했습니다.
                //data 배열을 복구해서 적절하게 사용하시면됩니다.
            }
            else
            {
                //읽기에 실패 했습니다. 오류메시지를 출력하던지 합니다.
            }
    }
}
Colored by Color Scripter
cs

던전워즈 게임소개입니다,

래머 — Thu, 15 Oct 2015 16:48:52 +0900

2015년경 출시한 게임입니다.

유니티로 제작했고, 서버 없이 구글플레이 게임서비스와 쿠폰 사용부분에서

JSP기반 웹서버를 조금이용했습니다.

구글플레이, 애플스토어, 네이버스토어, 원스토어에 출시를 했지만

현재는 개인사정으로 애플, 원스토어 버전만 서비스 중입니다.

애플앱스토어 : https://itunes.apple.com/us/app/dungeon-wars/id1053285564?l=ko&ls=1&mt=8

원스토어 :https://www.onestore.co.kr/userpoc/game/view?pid=0000694826(유료버전)

아래는 유니티 웹GL로 컨버팅한 버전입니다.

웹GL을 지원하는 웹브라우저에서 플레이 할 수 있습니다.(크롬, 엣지, 파이어폭스등등)

멈춘것 같이 보이지만 로딩까지 시간이 좀 걸릴 수 있습니다.

앱스토어 가이드라인

래머 — Sat, 10 Oct 2015 17:50:03 +0900

애플 앱스토어 가이드라인을 한번도 본적이 없어서 이번에 앱출시를 위해 한번 정독해봤습니다.

안되는 영어실력으로 끙끙거리며 번역해봤는데 내용이 많아서 다번역하지는 못했고 우리앱에 중요하다고 생각되는 항목에 대한 부분만 번역해봤습니다.

오역의역이 있을수 있으니 단순참고만 부탁드립니다.

2. Functionality(기능성)

2.1

Apps that crash will be rejected

크래시되는 앱은 거부된다.

2.2

Apps that exhibit bugs will be rejected

버그가 보이는 앱은 거부된다.

2.3

Apps that do not perform as advertised by the developer will be rejected

2.4

Apps that include undocumented or hidden features inconsistent with the description of the App will be rejected

설명과 일치하지 않거나 문서에 없는 또는 숨겨진 기능이 있는 앱은 거부된다.

2.5

Apps that use non-public APIs will be rejected

비공개 API들을 사용한 앱은 거부된다.

2.6

Apps that read or write data outside its designated container area will be rejected

앱에 지정되지 않은 위치에 데이터를 기록하거나 읽는 앱은 거부된다.

2.7

Apps that download code in any way or form will be rejected

어떠한 형태나 방법으로든 코드를 다운로드 하는 앱은 거부된다.

2.8

Apps that install or launch other executable code will be rejected

설치 또는 다른 실행 코드를 호출하는 앱은 거부된다.

2.9

Apps that are "demo", "trial", or "test" versions will be rejected. Beta Apps may only be submitted through TestFlight and must follow the TestFlight guidelines

데모, 트라이얼, 테스트 버전의 앱들은 거부된다. 베타앱들은 테스트플라이트를 통해서 제출될 수 있고, 테스트 플라이트 가이드 라인을 반드시 지켜야한다.

2.10

iPhone Apps must also run on iPad without modification, at iPhone resolution, and at 2X iPhone 3GS resolution

아이폰의 앱들은 반드시 수정없이 아이폰 해상도 또는 2x아이폰 3gs해상도 형태로 아이패드에서 실행되어야한다.

2.11

Apps that duplicate Apps already in the App Store may be rejected, particularly if there are many of them, such as fart, burp, flashlight, and Kama Sutra Apps

이미 앱스토에있는 앱들,특히나 방귀, 트럼, 플래시라이트, 가마수투라 앱 같은 앱들은 거부된다.

2.12

Apps that are not very useful, unique, are simply web sites bundled as Apps, or do not provide any lasting entertainment value may be rejected

매우 유용하지 않거나, 유일하거나(자기자신만을 위한앱같은), 단순히 웹사이트에 연결되거나, 어떠한 영구적인 컨테츠를 제공하지 않는 앱은 거부된다.

2.13

Apps that are primarily marketing materials or advertisements will be rejected

마케팅, 광고를 목적으로 하는 앱들은 거부된다.

2.14

Apps that are intended to provide trick or fake functionality that are not clearly marked as such will be rejected

의도적으로 속이거나 명백하게 표시되지 않은 형태로 가짜 기능을 제공하는 앱들은 거부된다.

2.15

Apps larger than 100MB in size will not download over cellular networks (this is automatically prohibited by the App Store)

100Mb이상크기의 앱들은 셀루러 네트워크(통신사 네트워크)를 통해서 다운로드 되지 않는다.(이것은 앱스토어에서 자동으로 금지 시킨다.)

2.16

Multitasking Apps may only use background services for their intended purposes: VoIP, audio playback, location, task completion, local notifications, etc.

멀티 태스킹 앱들은 그들의 의도한 목적에 맞게 백스라운드 서비스를 사용해야한다. : VoIP, 오디오 플레이, 위치, 작업완성, 로컬 통지, 기타

2.17

Apps that browse the web must use the iOS WebKit framework and WebKit Javascript

웹 탐색은 반드시 iOS Webkit 프레임워크 및 Webkit 자바 스크립트를 사용해야한다.

2.18

Apps that encourage excessive consumption of alcohol or illegal substances, or encourage minors to consume alcohol or smoke cigarettes, will be rejected

과도한 알코올 소비, 불법 행위, 미성년자에게 알코올 소비 또는 담배 피우기를 권유하는 앱은 거부된다.

2.19

Apps that provide incorrect diagnostic or other inaccurate device data will be rejected

잘못된 진단이나 부정확한 디바이스 데이터를 제공하는 앱은 거부된다.

2.20

Developers "spamming" the App Store with many versions of similar Apps will be removed from the iOS Developer Program

비슷한 형태의 앱을 다량 앱스토어에 게시하는 개발자는 개발자 프로그램에서 제외된다.

2.21

Apps that are simply a song or movie should be submitted to the iTunes store. Apps that are simply a book should be submitted to the iBooks Store

노래, 영화는 아이튠즈 스토어, 책은 iBook스토에서 제출될것이다.

2.22

Apps that arbitrarily restrict which users may use the App, such as by location or carrier, may be rejected

위치나 캐리어 같은 것으로 유저의 앱사용을 임의로 제한하는 앱들은 거부될것이다.

2.23

Apps must follow the iOS Data Storage Guidelines or they will be rejected

앱들은 반드시 iOS 데이터 저장소 가이드라인을 따라야 한다.

2.24

Apps that are offered in Newsstand must comply with schedules 1, 2 and 3 of the Program License Agreement or they will be rejected

뉴스스텐드에 공급되는 앱은 프로그램 라이선스 협정의 스케쥴 1, 2, 3을 따라야한다.

2.25

Apps that display Apps other than your own for purchase or promotion in a manner similar to or confusing with the App Store will be rejected

당신 소유가 아닌 앱의 구매 또는 프로모션을 위해 앱을 표시거나 기타 유사한 형태를 부추기는 앱들은 거부된다.

2.26

Apps may display and recommend apps other than your own only if the collection is designed for a specific approved need (e.g. health management, aviation, accessibility, etc.) or provides significant added value for a specific group of customers, or they will be rejected

앱들은 만일 수집물이 특별히 공인된 필요에 의하거나(건강관리, 비행, 접근성 기타) 또는 고객의 특별한 그룹을 위한 중요한 부가 가치를 제공하기 위해서인 경우 다른 것 보다는 당신 소유의 앱을 표시 또는 권장할 수 있다,

3. Metadata (name, descriptions, ratings, rankings, etc.)

메타데이터(이름, 설명, 평가, 랭킹, 기타)

3.1

Apps or metadata that mentions the name of any other mobile platform will be rejected

앱이름 또는 메터데이터에 공식적으로 다른 모바일 플랫폼을 언급하는 앱들은 거부된다.(안드로이드, 아이폰, 아이패드, 애플, 구글 처럼 다른 모바일플랫폼(애플포함)을 언급하지 말라는 소리)

3.2

Apps with placeholder text will be rejected

3.3

Apps with names, descriptions, screenshots, or previews not relevant to the content and functionality of the App will be rejected

앱의 이름, 설명, 스크린샷에 앱과 관계없는 컨텐츠가 포함된 앱은 거부된다.

3.4

App names in iTunes Connect and as displayed on a device should be similar, so as not to cause confusion

아이튠즈 컨넥터에 표시되는 앱이름과 디바이스에 표시되는 앱이름은 유사해야하며 혼동되지 않아야한다.

3.5

Small and large App icons should be similar, so as to not to cause confusion

작은 아이콘과 큰아이콘은 유사해서 혼동되지 않아야한다.

3.6

Apps with App icons, screenshots, and previews that do not adhere to the 4+ age rating will be rejected

앱아이콘, 스크린샷, 미리보기가 4세 미만 연령에 충실하지 않으면 거부된다.

3.7

Apps with Category and Genre selections that are not appropriate for the App content will be rejected

앱의 카타고리와 장르가 앱의 컨텐츠와 부합되지 않으면 거부된다.

3.8

Developers are responsible for assigning appropriate ratings to their Apps. Inappropriate ratings may be changed/deleted by Apple

개발자는 자신의 앱에 합당한 평가를 받을 책임이 있다. 부당하게 평가된 앱은 변경되거나 애플로부터 지워질것이다.(평점조작하지말란소리)

3.9

Developers are responsible for assigning appropriate keywords for their Apps. Inappropriate keywords may be changed/deleted by Apple

개발자는 자신의 앱에 적합한 키워드를 사용해야한다. 부당한 키워드는 애플이 변경하거나 지울것이다.

3.10

Developers who attempt to manipulate or cheat the user reviews or chart ranking in the App Store with fake or paid reviews, or any other inappropriate methods will be removed from the iOS Developer Program

유저의 리뷰 또는 앱스토어내의 차트 랭킹을 조작하거나, 가짜 유급 리뷰(돈주고 리뷰)를 시도 또는 유사한 형태의 부당한 방법을 시도하는 개발자는 개발자 프로그램에서 제외된다.

3.11

Apps that recommend that users restart their iOS device prior to installation or launch may be rejected

앱을 설치/실행하기전에 iOS디바이스를 제시작하도록 권장하는 앱은 거부된다.

3.12

Apps should have all included URLs fully functional when you submit it for review, such as support and privacy policy URLs

리뷰시에 앱내에 포함된 모든 URL들은 완전한 기능을 제공해야한다(고객지원, 개인정보 취급방침같은것들 및 기타 ).

3.13

Apps with screenshots, previews, and marketing text that do not clearly identify supplemental content or items that must be purchased separately (e.g. using IAP) will be rejected

스크린샷, 미리보기 및 마케팅 텍스트에 표시된 내용중 구매를(IAP같은) 통해서 부분적으로 제공되는 컨텐츠라고 확실하게 표시하지 않은 내용이 포함된 앱은 거부된다.

(예를들어 구매를 해야지만 사용할 수 있는 내용을 스크린샷이나 설명에 적어놓고, 이건 구매해야지 사용할 수 있다고 설명하지 않은경우)

3.14

App previews may only use video screen captures of the app, voice-overs, and textual and design overlays, or the app will be rejected

앱 미리보기에는 오직 앱으로부터 캡쳐된 비디오 스크린샷이나 음성들, 텍스트등을 사용해야한다.

3.15

Apps with previews that display personal information of a real person without permission will be rejected

앱 미리보기에 허가없이 실제개인 정보를 출력하는 앱은 거부된다.

3.16

App previews may only include music that is licensed for that purpose in all selected territories

앱 미리보기에는 모든 선택된 목적 지역에서 라이센스된 음악만 포함해야한다.

3.17

App previews that include content played or streamed via the app (e.g. iTunes playlist, YouTube streaming video) that is not licensed for use in the preview will be rejected

앱미리보기에 플레이 또는 스트림되는 컨텐츠가 라이선스되지 않은경우에는 거부된다.

4. Location(위치)

4.1

Apps that do not notify and obtain user consent before collecting, transmitting, or using location data will be rejected

사용자 동의없이 위치정보를 수집, 전송, 이용하는 앱은 거부된다.

4.2

Apps that use location-based APIs for automatic or autonomous control of vehicles, aircraft, or other devices will be rejected

위치 기반API를 차량, 항공기, 또는 다른 디바이스를 자동 또는 자율적으로 제어하기위해 사용하는 앱은 거부된다.

4.3

Apps that use location-based APIs for emergency services will be rejected

위치기반 API를 긴급 서비스에 사용하는 앱들은 거부된다.

4.4

Location data can only be used when directly relevant to the features and services provided by the App to the user or to support approved advertising uses

위치데이터는 앱이 사용자를 지원 또는 공인된 광고를 사용하는등의 직접적인 관계가 있는 기능 또는 서비스를 제공할때만 사용할 수 있다.

5. Push Notifications(푸시 알림)

5.1

Apps that provide Push Notifications without using the Apple Push Notification (APN) API will be rejected

애플의 푸시알림(APN) API를사용하지 않고 푸시알림을 제공하는 앱은 거부된다.

5.2

Apps that use the APN service without obtaining a Push Application ID from Apple will be rejected

알려진 애플의 푸시 어플레케이션 ID없이 APN 서비스를 사용하는 앱은 거부될것이다.

5.3

Apps that send Push Notifications without first obtaining user consent, as well as apps that require Push Notifications to function, will be rejected

앱이 푸시알림 기능 요구에 대한 동의없이 푸시알림을 보내는 경우 거부된다.

5.4

Apps that send sensitive personal or confidential information using Push Notifications will be rejected

민감한 개인또는 비밀 정보를 푸시알림으로 보내는경우 거부된다.

5.5

Apps that use Push Notifications to send unsolicited messages, or for the purpose of phishing or spamming will be rejected

청하지 않은 메시지나, 피싱, 스팸을 목적으로 한 푸시 알림을 보내는 경우 거부된다.

5.6

Apps cannot use Push Notifications to send advertising, promotions, or direct marketing of any kind

앱은 광고, 프로모션 또는 어떠한 종류의 직접적인 마케팅에 푸시 알림을 사용할 수 없다.

5.7

Apps cannot charge users for use of Push Notifications

앱은 푸시알림 이용에 대한 경비를 유저에게 부담시킬 수 없다.

5.8

Apps that excessively use the network capacity or bandwidth of the APN service or unduly burden a device with Push Notifications will be rejected

APN서비스에 지나치게 네트워크 용량 또는 대역폭을 사용하거나, 디바이스에 지나치게 부담을 주는경우 거부된다.

5.9

Apps that transmit viruses, files, computer code, or programs that may harm or disrupt the normal operation of the APN service will be rejected

해를 끼치거나 APN서비스의 일반적인 작동을 붕괴시키는 바이러스, 컴퓨터코드, 또는 프로그램을 전송하는 앱은 거부된다.

6. Game Center(게임센터)

6.1

Apps that display any Player ID to end users or any third party will be rejected

최종사용자의 플레이어 ID또는 서드파티를 표시하는 앱은 거부된다.

6.2

Apps that use Player IDs for any use other than as approved by the Game Center terms will be rejected

게임센터의 공인된 플레이어 ID를 사용하지 않는 앱은 거부된다.

6.3

Developers that attempt to reverse lookup, trace, relate, associate, mine, harvest, or otherwise exploit Player IDs, aliases, or other information obtained through Game Center will be removed from the iOS Developer Program

개발자는 검색, 추적, 관계, 제휴, mine, 수확, 플레이어 ID의 부당한 사용, 별명, 또는 게임센터를 통해서 연결된 다른 정보를 리버스 하는경우 iOS개발자 프로그램에서 제외된다.

6.4

Game Center information, such as Leaderboard scores, may only be used in Apps approved for use with Game Center

리더보드 점수 같은 게임센터의 정보는 오직 공인된 게임센터와 함께 사용할 수 있다.

6.5

Apps that use the Game Center service to send unsolicited messages, or for the purpose of phishing or spamming will be rejected

게임센터 서비스를 청하지 않은 메시지 전송, 또는 피싱, 스팸목적으로 이용하는 앱은 거부된다.

6.6

Apps that excessively use the network capacity or bandwidth of Game Center will be rejected

게임센터의 네트워크 용량이나 대역폭을 지나치게 소모하는 앱은 거부된다.

6.7

Apps that transmit viruses, files, computer code, or programs that may harm or disrupt the normal operation of the Game Center service will be rejected

피해를 주거나 게임센터 서비스의 정상적인 운영을 방해할 목적으로 바이러스, 파일들, 컴퓨터코드 또는 프로그램을 전송하는 앱은 거부된다.

7. Advertising(광고)

7.1

Apps that artificially increase the number of impressions or click-throughs of ads will be rejected

인위적으로 광고의 클릭 또는 impressions를 증가 시키는 앱은 거부된다.

7.2

Apps that contain empty iAd banners will be rejected

비어있는 iAD배너를 포함한 앱은 거부된다.

7.3

Apps that are designed predominantly for the display of ads will be rejected

광고 표시를 목적으로 하기 위해 디자인된 앱은 거부된다.

8. Content and Intellectual Property Rights(컨첸츠와 지적 재산권)

8.1

Apps must comply with all terms and conditions explained in the Guidelines for Using Apple Trademarks and Copyrights and the Apple Trademark List

8.2

Apps that suggest or infer that Apple is a source or supplier of the App, or that Apple endorses any particular representation regarding quality or functionality will be rejected

애플이 공급하거나, 애플 앱 공급자이거나 또는 품질이나 기능을 애플이 보증한다는 등의 어떠한

암시나 결론을 내도록 표시하는 앱은 거부된다.

8.3

Apps that appear confusingly similar to an existing Apple product, interface, or advertising theme will be rejected

이미 있는 애플 제품의 인터페이스 또는 광고 테마와 유사하거나 혼란을 부추기는 앱은 거부된다.

8.4

Apps that misspell Apple product names in their App name (i.e., GPS for Iphone, iTunz) will be rejected

앱이름에 잘못된 철자의 애플 제품이름을 사용하는 앱은 거부된다.(예 GPS for iphone, iTunz)

8.5

Apps may not use protected third party material such as trademarks, copyrights, patents or violate 3rd party terms of use. Authorization to use such material must be provided upon request

8.6

Apps that include the ability to download music or video content from third party sources (e.g. YouTube, SoundCloud, Vimeo, etc) without explicit authorization from those sources will be rejected

음악이나 비디오 컨텐츠를 관련자들의 명백한 인가없이 제3자의 소스(유튜브, 사운드클라우드, Vimeo 등)로부터 다운로드 하는앱은 거부된다.

9. Media content(미디어 컨텐트)

9.1

Apps that do not use the MediaPlayer framework to access media in the Music Library will be rejected

음악라이브러리 내부의 미디어 액세스를 위해 MediaPlayer를 사용하는 앱은 거부된다.

9.2

App user interfaces that mimic any iPod or iTunes interface will be rejected

앱 사용자 인터페이스가 iPod또는 iTunes 인터페이스를 흉내 내는 경우 거부된다.

9.3

Audio streaming content over a cellular network may not use more than 5MB over 5 minutes

셀루러 네트워크를 통한 오디오 컨텐츠 스트리밍은 5분동안 5MB이상 초과 사용할 수없다.

9.4

Video streaming content over a cellular network longer than 10 minutes must use HTTP Live Streaming and include a baseline 192 kbps or lower HTTP Live stream

셀루러 네트워크를 통해 10분이상의 비디오 컨텐츠 스트리밍하는 경우 반드시 HTTP 라이브 스트리밍을 사용해야하며, 192 kbps 또는 그이하의 HTTP Live 스트림 제한선을 포함해야한다.

10. User interface(사용자 인터페이스)

10.1

Apps must comply with all terms and conditions explained in the Apple iOS Human Interface Guidelines

앱은 애플 iOS 휴먼 인터페이스 가이드라인에 설명된 계약과 조건을 반드시 따라야한다.

10.2

Apps that look similar to Apps bundled on iOS or Watch OS devices, including the App Store, iTunes Store, and iBooks Store, will be rejected

iOS또는 Watch OS디바이스의 번들과 유사하게 보이거나, 앱스토어, iTunes스토어, iBook 스토어등과 유사한 기능을 포함하는경우 거부된다.

10.3

Apps that do not use system provided items, such as buttons and icons, correctly and as described in the Apple iOS Human Interface Guidelines may be rejected

애플 iOS 휴먼 인터페이스 가이드라인에 올바르게 설명된되로, 버튼이나 아이콘 같은 시스템을 위해 제공된 아이템들을 사용하는경우 거부된다.

10.4

Apps that create alternate desktop/home screen environments or simulate multi-App widget experiences will be rejected

데스크탑/홈 스크린 환경 또는 다중앱 위젯 경험을 시뮬레이트 하는 앱은 거부된다.

10.5

Apps that alter the functions of standard switches, such as the Volume Up/Down and Ring/Silent switches, will be rejected

볼륨 업/다운, 링/사일런트 스위치 같은 표준 스위치 기능을 변경시키는 앱은 거부된다.

10.6

Apple and our customers place a high value on simple, refined, creative, well thought through interfaces. They take more work but are worth it. Apple sets a high bar. If your user interface is complex or less than very good, it may be rejected

애플과 우리의 고객들은 인터페이스의 단순함, 세련됨, 창조성에 높은 가치를 둔다. 그것은 더 많은 작업이 필요하지만 가치가 있다. 애플은 높은 빗장을 만든다. 만일 당신의 사용자 인터페이스가 복잡하거나, 최상이 아니라면, 그것은 거부될것이다.

10.7

Watch Apps whose primary function is telling time will be rejected

워치앱의 주된 기능이 시간을 말하는 것이라면 거부될것이다.

11. Purchasing and currencies(구매와 통화)

11.1

Apps that unlock or enable additional features or functionality with mechanisms other than the App Store will be rejected

앱이 앱스토어에 있는 다른 앱들의 추가기능이나 특징들을 잠금해제하거나, 활성화 시키는 경우 거부된다.

11.2

Apps utilizing a system other than the In-App Purchase API (IAP) to purchase content, functionality, or services in an App will be rejected

앱이 앱내의 컨텐츠나 기능, 또는 서비스 구매에 In-App 구매 API대신 다른 시스템을 사용하는경우 거부된다.

11.3

Apps using IAP to purchase physical goods or goods and services used outside of the App will be rejected

앱이 앱 외부의 실제 물건 또는 물건들과 서비스를 이용을 구매하는데 IAP를 사용하는경우 거부된다.

11.4

Apps that use IAP to purchase credits or other currencies must consume those credits within the App

IAP를사용하여 구매한 크레딧 또는 다른 통화들은 반드시 앱내에서 소모되어야한다.

11.5

Apps that use IAP to purchase credits or other currencies that expire will be rejected

IAP를 사용하여 구매한 크레딧이나 다른 통화의 기간이 만료되는 경우 거부된다.

11.6

Content subscriptions using IAP must last a minimum of 7 days and be available to the user from all of their iOS devices

IAP를 사용한 구독 컨텐츠들은 기간이 최소 7일이며, 다른 모든 iOS디바이스들에서 사용할 수 있어야한다.

11.7

Apps that use IAP to purchase items must assign the correct Purchasability type

IAP를 사용하여 구매하는 아이템들에는 올바른 구매 타입을 할당해야한다.

11.8

Apps that use IAP to purchase access to built-in capabilities provided by iOS, such as the camera or the gyroscope, will be rejected

iOS에서 기본 제공되는 카메라 또는 자이로스코프 같은 기본 기능에 IAP구매를 사용하는앱은 거부된다.

11.9

Apps containing content or services that expire after a limited time will be rejected, except for specific approved content (e.g. films, television programs, music, books)

제한된 시간이후에 컨텐츠나 서비스가 만료되는 앱은 특별히 공인된 컨텐츠들(영화들, 텔레비전 프로그램, 음악, 책)을 제외하고는 거부될 것이다,

11.10

Insurance Apps must be free, in legal-compliance in the regions distributed, and cannot use IAP

보험앱들은 배포지역의 법을 준수해야하며, IAP를 사용할 수 없다.

11.11

In general, the more expensive your App, the more thoroughly we will review it

일반적으로, 당신이 앱이 다른것들에 비해 더 비싼경우, 우리는 더욱 철저히 심사할것이다.

11.12

Apps offering subscriptions must do so using IAP, Apple will share the same 70/30 revenue split with developers for these purchases, as set forth in the Program License Agreement

구독을 제공하는 앱들은 반드시 IAP를 사용해야하며, 4번째의 프로그램 라이선스 협정에 설정한것으로 애플은 개발자와 70/30으로 이익을 분배한다.

11.13

Apps that link to external mechanisms for purchases or subscriptions to be used in the App, such as a "buy" button that goes to a web site to purchase a digital book, will be rejected

앱내에서 “buy” 버튼을 눌러서 책 구매를 위해 웹사이트로 가는것과 같이 외부의 구매 또는 구독 매카니즘 링크를 사용하는 앱은 거부된다.

11.14

Apps can read or play approved content (specifically magazines, newspapers, books, audio, music, video and cloud storage) that is subscribed to or purchased outside of the App, as long as there is no button or external link in the App to purchase the approved content. Apple will only receive a portion of revenues for content purchased inside the App

앱에서 공인된 컨텐츠를 읽거나 플레이 할 수 있으며(특별한 메거진, 신문, 책, 오디오, 음악, 비디오, 클라우드 저장소) 앱내에 구매를 위한 버튼이나 외부링크가 없기만하면, 앱의 외부에서 구매 또는 구독이 가능하다, 애플은 오직 앱 내부에서 구매된 컨텐츠 수입의 일부만 받을것이다.

11.15

Apps may only use auto-renewing subscriptions for periodicals (newspapers, magazines), business Apps (enterprise, productivity, professional creative, cloud storage), and media Apps (video, audio, voice), or the App will be rejected

자동 갱신 구독은 정기 간행물만(신문, 매거진) 사용할 수 있으며, 비즈니스앱들(기업, 생산성, 전문 창조, 클라우드 저장소)와 미디어앱들(비디오, 오디오, 음성)이 사용하는경우 거부될것이다.

11.16

Apps may enable additional approved features or functionality when used in combination with specific approved physical products (such as a toy) as long as the additional features and functionality are either completely dependent on such hardware (for example an App that is used to control a telescope) or also available through the App without the physical products, such as by way of reward for achievement or by use of IAP

11.17

Apps may facilitate transmission of approved virtual currencies provided that they do so in compliance with all state and federal laws for the territories in which the app functions

12. Scraping and aggregation

12.1

Apps that scrape any information from Apple sites (for example from apple.com, iTunes Store, App Store, iTunes Connect, Apple Developer Programs, etc.) or create rankings using content from Apple sites and services will be rejected

앱이 애플 사이트로부터의 어떠한 정보를 모은것이거나(예를들어 apple.com, 아이튠즈스토어, 앱스토어, 아이튠즈컨넥트, 애플개발자프로그램, 기타) 애플사이트나 서비스 컨텐츠를 사용하여 순위를 생성하는 형태인경우 거부된다.

12.2

Apps may use approved Apple RSS feeds such as the iTunes Store RSS feed

앱은 아이튠즈 스토어의 RSS피드와 같은 공인된 애플의 RSS피드를 사용해야한다.

12.3

Apps that are simply web clippings, content aggregators, or a collection of links, may be rejected

앱이 단지 웹페이지 스크랩, 컨텐츠 조각 모음, 링크의 모음인 경우 거부된다.

13. Damage or injury(손해 또는 상해)

13.1

Apps that encourage users to use an Apple Device in a way that may cause damage to the device will be rejected

장치에 피해를 유발할 수 있는 방법으로 애플 장치를 사용을 유도하는 앱은 거부된다.

13.2

Apps that rapidly drain the device's battery or generate excessive heat will be rejected

급격히 장치 배터리를 소모하거나, 과도한 열을 발생시키는 앱은 거부된다.

13.3

Apps whose use may result in physical harm may be rejected

앱사용으로 물리적인 손해를 끼치는 앱은 거부된다.

14. Personal attacks(인신공격)

14.1

Any App that is defamatory, offensive, mean-spirited, or likely to place the targeted individual or group in harm's way will be rejected

명예훼손, 모욕적, 공격적인의미, 또는 개인이나 그룹을 대상으로 해를 끼치는 형태의 앱은 거부된다.

14.2

Professional political satirists and humorists are exempt from the ban on offensive or mean-spirited commentary

전문적인 정치 풍자가나 유머작가의 경우 모욕 또는 공격적의미의 해설 금지로부터 면제된다.

14.3

Apps that display user generated content must include a method for filtering objectionable material, a mechanism for users to flag offensive content, and the ability to block abusive users from the service

사용자가 생성한 컨텐츠를 표시하는 앱들은 반드시 사용자들의 모욕적인 컨텐츠에 표기하는 매커니즘이나 서비스로부터 사용자들의 욕설을 차단하는것과 같은 형태로 기분이 상할 만한 내용들에 대한 필터링을 포함해야한다.

15. Violence(폭력)

15.1

Apps portraying realistic images of people or animals being killed or maimed, shot, stabbed, tortured or injured will be rejected

실제와 같은 이미지로 사람이나 동물들을 죽음, 불구, 총에맞거나, 찔림, 고통스러움, 상처입음 과 같은 표현을 하는 앱은 거부된다.

15.2

Apps that depict violence or abuse of children will be rejected

아동에 대한 폭력이나 학대를 묘사한 앱은 거부될것이다.

15.3

"Enemies" within the context of a game cannot solely target a specific race, culture, a real government or corporation, or any other real entity

게임내 배경이 되는 적들은 구체적인 단일의 형태인 인종, 문화, 실제정부, 회사, 또는 다른 실제 존재들이 될 수 없다.

15.4

Apps involving realistic depictions of weapons in such a way as to encourage illegal or reckless use of such weapons will be rejected

무기같은것의 불법 또는 무모한 사용을 부추기는 방법으로 무기의 현실적인 묘사에 몰두한 앱들은 거부된다.

15.5

Apps that include games of Russian roulette will be rejected

러시안 룰렛 게임을 포함한 앱은 거부된다.

16. Objectionable content(기분이 상할만한 내용)

16.1

Apps that present excessively objectionable or crude content will be rejected

지나치게 기분이 상할만 하거나 천연그대로의 컨텐츠를 포함한 앱은 거부된다.

16.2

Apps that are primarily designed to upset or disgust users will be rejected

주로 고의 적인 전복 또는 사용자 혐오가 목적인 앱은 거부된다.

17. Privacy(사생활)

17.1

Apps cannot transmit data about a user without obtaining the user's prior permission and providing the user with access to information about how and where the data will be used

어떠한 또는 어딘가의 데이터들에 대한 정보에 접근하기 위해서 사용자의 주된 허가나 제공없이 데이터를 전송하는 앱은 거부된다.

17.2

Apps that require users to share personal information, such as email address and date of birth, in order to function will be rejected

기능을 위해서 사용자의 이메일이나, 생일같은 개인정보의 공유를 요구하는 앱은 거부된다.

17.3

Apps may ask for date of birth (or use other age-gating mechanisms) only for the purpose of complying with applicable children's privacy statutes, but must include some useful functionality or entertainment value regardless of the user's age

어린이 사생활 범률적용에 따르기 위한 목적으로 생일(또는 다른 나이확인 매커니즘 사용)을 물어 볼 수 있다, 그러나 반드시 몇가지 유용한 기능이나 사용자 나이의 관계없는 서비스적 가치를 포함해야한다.

17.4

Apps that collect, transmit, or have the capability to share personal information (e.g. name, address, email, location, photos, videos, drawings, the ability to chat, other personal data, or persistent identifiers used in combination with any of the above) from a minor must comply with applicable children's privacy statutes, and must include a privacy policy

미성년자로 부터 수집, 전송, 개인정보 공유(예를 들어 이름, 주소, 이메일, 위치, 사진, 비디오, 그리기, 채팅, 기타 개인정보 또는 위의 어떠한 데이터를 이용한 지속적인 식별가능함)하는경우 반드시 아동 사생활 범률을 따라야 하며, 개인정보 취급방침을 포함해야 한다.

17.5

Apps that include account registration or access a user’s existing account must include a privacy policy or they will be rejected

계정 등록을 포함하거나 유저가 보유한 계정에 접근하는 앱들은 반드시 개인정보 취급방침을 포함해야한다.

18. Pornography(포르노그래피)

18.1

Apps containing pornographic material, defined by Webster's Dictionary as "explicit descriptions or displays of sexual organs or activities intended to stimulate erotic rather than aesthetic or emotional feelings", will be rejected

포르노그래픽을 포함하거나, Webster's 사전에 선언된 “확실한 설명 또는 성적인 표현, 미학적 또는 감정적 관점을 벗어난 성적 호기심을 자극시키는” 앱은 거부된다.

18.2

Apps that contain user generated content that is frequently pornographic (e.g. "Chat Roulette" Apps) will be rejected

사용자가 만든 컨텐츠에 포함된 내용이 빈번한 포르노 그래픽을 포함하는경우 거부된다.

19. Religion, culture, and ethnicity(종교, 문화, 민족성)

19.1

Apps containing references or commentary about a religious, cultural or ethnic group that are defamatory, offensive, mean-spirited or likely to expose the targeted group to harm or violence will be rejected

앱에는 종교적인 참조나 주석을 담을 수 있지만, 종교, 문화,민족에 대한 명예회손, 모욕행위, 기분 나쁜 의미들, 특정 단체에 대해 해를 입히기 위한 폭로들이 포함되는경우 거부될것이다.

19.2

Apps may contain or quote religious text provided the quotes or translations are accurate and not misleading. Commentary should be educational or informative rather than inflammatory

종교적인 내용을 인용하거나 포함할 수 있지만, 정확하게 해석되어야 하며, 오도해서는 안된다.

해설은 자극적이지 않아야 하며, 교육적이거나 정보 재공을 위한 목적이어야한다.

20. Contests, sweepstakes, lotteries, raffles, and gambling(콘테스트, 경마, 복권, 도박)

20.1

Sweepstakes and contests must be sponsored by the developer/company of the App

20.2

Official rules for sweepstakes and contests must be presented in the App and make it clear that Apple is not a sponsor or involved in the activity in any manner

20.3

It must be permissible by law for the developer to run a lottery App, and a lottery App must have all of the following characteristics: consideration, chance, and a prize

20.4

Apps that allow a user to directly purchase a raffle ticket in the App will be rejected

20.5

Apps that offer real money gaming (e.g. sports betting, poker, casino games, horse racing) or lotteries must have necessary licensing and permissions in the locations where the App is used, must be restricted to those locations, and must be free on the App Store

20.6

Apps that use IAP to purchase credit or currency to use in conjunction with real money gaming will be rejected

21. Charities and contributions(자선과 기부)

21.1

Apps that include the ability to make donations to recognized charitable organizations must be free

21.2

The collection of charitable donations must be done via a web site in Safari or an SMS

22. Legal requirements(범률 요구)

22.1

Apps must comply with all legal requirements in any location where they are made available to users. It is the developer's obligation to understand and conform to all local laws

앱 사용자들의 지역적 범률 요구를 반드시 따라야 한다. 개발자는 법을 이해하고, 지역법을 따라야한다.

22.2

Apps that contain false, fraudulent or misleading representations or use names or icons similar to other Apps will be rejected

앱이 거짓, 사기, 오도된 설명을 포함하거나 다른앱과 비슷한 이름, 아이콘을 사용하는 경우 거부된다.

22.3

Apps that solicit, promote, or encourage criminal or clearly reckless behavior will be rejected

구걸하거나, 조장, 범죄 행위나 무모한 행동을 부추기는 앱은 거부된다.

22.4

Apps that enable illegal file sharing will be rejected

불법적인 파일 공유를 활성화시키는 앱은 거부된다.

22.5

Apps that are designed for use as illegal gambling aids, including card counters, will be rejected

불법 aids 도박, card counters를 포함하기 위해 디자인된 앱은 거부된다.

22.6

Apps that enable anonymous or prank phone calls or SMS/MMS messaging will be rejected

익명 또는 장난전화 SMS/MMS메시지를 보내는 앱은 거부된다.

22.7

Developers who create Apps that surreptitiously attempt to discover user passwords or other private user data will be removed from the iOS Developer Program

사용자 비밀번호나 다른 개인데이터를 몰래 빼내려는 개발자는 개발자 프로그램에서 제외된다.

22.8

Apps that contain DUI checkpoints that are not published by law enforcement agencies, or encourage and enable drunk driving, will be rejected

22.9

Apps that calculate medicinal dosages must be submitted by the manufacturer of those medications or recognized institutions such as hospitals, insurance companies, and universities

의학적 투약을 계산하는 앱들은 반드시 약물의 제조사, 병원이나, 보험회사 및 대학 같이 공인된 협회만 게시할 수 있다.

22.10

Apps that use iTunes music previews in an unauthorized manner will be rejected

허가받지 않은 방법으로 아이튠즈 음악 미리듣기를 사용하는 앱은 거부된다.

23. Wallet

23.1

Wallet passes can be used to make or receive payments, transmit offers, or offer identification (such as movie tickets, airline tickets, coupons and reward offers). Other uses may result in the rejection of the App and the revocation of Wallet credentials

23.2

Passes must include valid contact information from the issuer of the pass or the App will be rejected and Wallet credentials may be revoked

23.3

Passes must be signed by the entity that will be distributing the pass under its own name, trademark, or brand or the App will be rejected and Wallet credentials may be revoked

24. Kids Category(아동 카테고리)

24.1

Apps in the Kids Category must include a privacy policy and must comply with applicable children's privacy statutes

24.2

Apps in the Kids Category may not include behavioral advertising (e.g. the advertiser may not serve ads based on the user's activity within the App), and any contextual ads presented in the App must be appropriate for kids

24.3

Apps in the Kids Category must get parental permission or use a parental gate before allowing the user to link out of the app or engage in commerce

24.4

Apps in the Kids Category must be made specifically for kids ages 5 and under, ages 6-8, or ages 9-11

25. Extensions(확장)

25.1

Apps hosting extensions must comply with the App Extension Programming Guide

25.2

Apps hosting extensions must provide some functionality (help screens, additional settings) or they will be rejected

25.3

Apps hosting extensions that include marketing, advertising, or in-app purchases in their extension view will be rejected

25.4

Keyboard extensions must provide a method for progressing to the next keyboard

25.5

Keyboard extensions must remain functional with no network access or they will be rejected

25.6

Keyboard extensions must provide Number and Decimal keyboard types as described in the App Extension Programming Guide or they will be rejected

25.7

Apps offering Keyboard extensions must have a primary category of Utilities and a privacy policy or they will be rejected

25.8

Apps offering Keyboard extensions may only collect user activity to enhance the functionality of their keyboard extension on the iOS device or they may be rejected

26. HomeKit

26.1

Apps using the HomeKit framework must have a primary purpose of providing home automation services

26.2

Apps using the HomeKit framework must indicate this usage in their marketing text and they must provide a privacy policy or they will be rejected

26.3

Apps must not use data gathered from the HomeKit APIs for advertising or other use-based data mining

26.4

Apps using data gathered from the HomeKit API for purposes other than improving the user experience or hardware/software performance in providing home automation functionality will be rejected

27. HealthKit and Human Subject Research

27.1

Apps using the HealthKit framework or conducting human subject research for health purposes, such as through the use of ResearchKit, must comply with applicable law for each Territory in which the App is made available, as well as Sections 3.3.28 and 3.3.39 of the iOS Developer Program License Agreement

27.2

Apps that write false or inaccurate data into HealthKit will be rejected

27.3

Apps using the HealthKit framework that store users’ health information in iCloud will be rejected

27.4

Apps may not use or disclose to third parties user data gathered from the HealthKit API or from health-related human subject research for advertising or other use-based data mining purposes other than improving health, or for the purpose of health research

27.5

Apps that share user data acquired via the HealthKit API with third parties without user consent will be rejected

27.6

Apps using the HealthKit framework must indicate integration with the Health app in their marketing text and must clearly identify the HealthKit functionality in the app’s user interface

27.7

Apps using the HealthKit framework or conducting human subject research must provide a privacy policy or they will be rejected

27.8

Apps that provide diagnoses, treatment advice, or control hardware designed to diagnose or treat medical conditions that do not provide written regulatory approval upon request will be rejected

27.9

Apps conducting health-related human subject research must obtain consent from participants or, in the case of minors, their parent or guardian. Such consent must include the (a) nature, purpose, and duration of the research; (b) procedures, risks, and benefits to the participant; (c) information about confidentiality and handling of data (including any sharing with third parties); (d) a point of contact for participant questions; and (e) the withdrawal process

27.10

Apps conducting health-related human subject research must secure approval from an independent ethics review board. Proof of such approval must be provided upon request.

28. TestFlight

28.1

Apps may only use TestFlight to beta test apps intended for public distribution and must comply with the full App Review Guidelines

28.2

Apps using TestFlight must be submitted for review whenever a build contains material changes to content or functionality

28.3

Apps using TestFlight may not be distributed to testers in exchange for compensation of any kind

29. Apple Pay

29.1

Apps using Apple Pay must provide all material purchase information to the user prior to sale of any good or service or they will be rejected; Apps using Apple Pay to offer recurring payments must, at a minimum, disclose the length of the renewal term and the fact that it will continue until canceled, what will be provided during each period, the charges that will be billed to the customer, and how to cancel.

29.2

Apps using Apple Pay must use Apple Pay branding and user interface elements correctly and as described in the Apple Pay Identity Guidelines or they will be rejected

29.3

Apps using Apple Pay as a purchasing mechanism may not offer goods or services that violate the law of any territory in which the good or service will be delivered and may not be used for any illegal purpose

29.4

Apps using Apple Pay must provide a privacy policy or they will be rejected

29.5

Apps using Apple Pay may only share user data acquired via Apple Pay with third parties when provided to facilitate or improve delivery of goods and services or to comply with legal requirements

네이버 앱스토어 인앱영수증 검증 c#버전

래머 — Sun, 13 Sep 2015 07:04:08 +0900

네이버의 경우 구글과 같은 형태로 영수증을 발급하고 있습니다.

그렇기 때문에 구글 결제모듈과 동일한 방법으로 영수증 검증을 하면되는데 차이점은

네이버결제 데이터에는 한글같은게 포함되기 때문에 약간의 수정이 있어야 합니다.

아래 코드는 네이버 결제 코드 검증 루틴의 코드입니다.

구글 검증루틴과 차이점은 아래 코드에서 진하게 표시해놓은(Encoding.UTF8.GetBytes(Message)) 부분입니다.

바운시 캐슬 암호화 루틴은 구글 결제 코드 예제에 보시면 포함되어 있고, 라이브러리를 포함하기 힘든경우에는

바운시 캐슬 사이트에서 소스 코드를 직접 받아서 사용하시면됩니다.

http://www.bouncycastle.org/

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
using Org.BouncyCastle.Security;
using Org.BouncyCastle.Crypto;
using Org.BouncyCastle.Crypto.Parameters;
using System.Security.Cryptography;
using System;
public class NaverSignatureVerify
    {
        RSAParameters _rsaKeyInfo;
 
        public NaverSignatureVerify(String strNaverPublicKey)
        {
            RsaKeyParameters rsaParameters = (RsaKeyParameters)PublicKeyFactory.CreateKey(Convert.FromBase64String(strNaverPublicKey));
 
            byte[] rsaExp = rsaParameters.Exponent.ToByteArray();
            byte[] Modulus = rsaParameters.Modulus.ToByteArray();
 
            // Microsoft RSAParameters modulo wants leading zero's removed so create new array with leading zero's removed
            int Pos = 0;
            for (int i = 0; i < Modulus.Length; i++)
            {
                if (Modulus[i] == 0)
                {
                    Pos++;
                }
                else
                {
                    break;
                }
            }
            byte[] rsaMod = new byte[Modulus.Length - Pos];
            Array.Copy(Modulus, Pos, rsaMod, 0, Modulus.Length - Pos);
 
            // Fill the Microsoft parameters
            _rsaKeyInfo = new RSAParameters()
            {
                Exponent = rsaExp,
                Modulus = rsaMod
            };
        }
 
        public bool Verify(String Message, String Signature)
        {
            if (Application.platform == RuntimePlatform.Android)
            {
                using (RSACryptoServiceProvider rsa = new RSACryptoServiceProvider())
                {
                    try
                    {
                        rsa.ImportParameters(_rsaKeyInfo);
                        return rsa.VerifyData(Encoding.UTF8.GetBytes(Message), "SHA1", Convert.FromBase64String(Signature));
                    }
                    catch (System.Exception ex)
                    {
#if NEED_LOG
                        Debug.Log("Verify failed : " + ex.ToString());
#endif
                        return false;
                    }
 
                }
            }
            else
            {
                return true;
            }
        }
    }
Colored by Color Scripter
cs

블록 게임

래머 — Sat, 22 Aug 2015 03:58:46 +0900

Unity Web Player | blockgame

빌보드 테스트

래머 — Sun, 16 Aug 2015 22:41:32 +0900

Unity Web Player | billboardtest

MPU6050 자이로 가속도 센서

래머 — Sat, 25 Jul 2015 18:58:30 +0900

자이로 와 가속도 센서가 포함된 센서입니다.

매우 유명하여 딱히 설명할 필요가 없는 센서인데,

예제또한 풍부합니다.

하지만 깔끔하게 센서제어 및 액세스에 관련한 부분만 만들어진것은 안보이는것 같아

제가 참고 했던 예제중 하나를 클래스로 래핑하여, 라이브러리화 했습니다.

사용법은 아래와 같습니다.

첨부 파일을 아두이노 라이브러리에 추가 하시고 사용하면됩니다.

칼만필터라는 예제를 수정한 버전인데 혹 이미 같은 라이브러리를 추가해놓으신경우에는

에러가 날 수 도 있겠습니다.

그런경우에는 CMPU6050.h 파일만 칼만필터 라이브러리 폴더내에 복사해 넣으시면되겠습니다.

첨부라이브러리

KalmanFilter.zip

예제소스코드

mpu6050test.zip

아두이노 작품 메뉴에 있는 밸런싱 로봇은 아래 라이브러리를 활용하여 만든것이니, 동작에 별문제 없다고 생각합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
#include <Arduino.h>
#include <Wire.h>
#include <Kalman.h>
#include <CMPU6050.h>
 
//mpu6050 매니저입니다. 단순히 누군가 만들어놓은 유명한 예제에서 mpu6050부분만 뽑아 클래스화 시킨겁니다.
CMpu6050Manager g_Mpu6050;
 
void setup()
{
  g_Mpu6050.Init(); //setup에서 반드시 한번 호출해 줍니다.
  Serial.begin(9600);
}
 
void loop()
{
 
  //매 루프마다 호출되게 해줍니다.
  g_Mpu6050.Update();
  
  //x값은 -90 ~ 90
  //y값은 -180 ~ 180범위
  //상보 필터(Complementary Filter) 
  float companglex = g_Mpu6050.GetCompAngleX();
  float compangley = g_Mpu6050.GetCompAngleY();
  
  //칼만 필터, 
  float kalmananglex = g_Mpu6050.GetKalAngleX();
  float kalmanangley = g_Mpu6050.GetKalAngleY();
 
  Serial.print("kalx : ");
  Serial.print(kalmananglex, 2);
  
  Serial.print("\tkaly : ");
  Serial.print(kalmanangley, 2);
  
  Serial.println();
  
  delay(500);
}
Colored by Color Scripter
cs